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GENERAL INFORMATION 
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COURSE DESCRIPTION 


This course trains a student to perform the duties and responsi- 
bilities of a DOS/VS Program Support Representative. The course is 
DOS/VS Release 29 oriented and teaches the student how to interpret 
DOS/VS operator messages, install PTFs, write APARsS, perform an SCP 
installation, diagnose coding and control card errors in IBM supplied 
or user written programs, and how to communicate effectively with the 
customer. 


During lab sessions the student diagnoses program errors in both user 
type and system control programs. User type errors are corrected to 
allow proper operation, and internal failures are corrected, 
circumvented or reported. An SCP installation is also performed. 


Prerequisites 

cc 11298 DOS/VS Basic Coding Techniques 
Os ciate 

Postrequisites 

cc 40016 Macro Definition 

cc 57247 DOS/VS Display Operator Console 


BASIC SKILLS 


Generalized Proqram Support Basic Skills 


Effectively gather the symptoms, severity, and related data of a 
problem with which to do problem determination and formulate an 
effective PASS search argument. 


Use the assistance of Second Level Support groups to obtain, install, 
and verify fixes for known problems. 


Prepare the necessary documentation of a problem and communicate this 
information to appropriate IBM and customer personnel, 


Define unknown problems and initiate action with the appropriate 
support resource groups to get resolution; create and submit an APAR 
along with proper supporting documentation on the problem. Monitor 
and effect customer communication on the progress of problem 
determination. 


Install, verify, and complete the necessary documentation for an SCP 
installation; perform installation-related customer skills. 


villi 


DOS/VS_ Basic S$ 


1. 


2 


3. 


11. 


14. 


15. 


18. 


19. 
20. 


21. 
22. 
23. 


24. 


Determine the status of any I/0 device by using the appropriate 
system I/0 control blocks. 

Locate and identify all non-I/0 control blocks that are within 
the resident supervisor. 7 

Use an Assesbler Language Listing and Linkage Editor Map to 
locate any given routine or instruction in a storage dump. , 
Obtain a storage dump that contains any desired routine in 
real/virtual storage. 

Order and install PTFs or other supplied fixes. 

Correctly write and submit an APAR. 

Prepare the required control cards and initiate any partition. to 
execute a program. 

List and use the correct procedure for obtaining technical data 
or assistance. 

Determine the status of any data file by using the appropriate 
system I/0 blocks. | 
Create and/or correct errors in labels on tape and disk. 
Determine the correct disk data area and print out the area for 
any data management system presented in this course. 

Make and use the correct control cards to restart from a 
checkpoint. 

Identify, analyze and take appropriate action for error messages. 
Use the correct PLM and microfiche to locate and trace the logic 
flow of any given instruction of any phase. 

Identify Job Control, IPL and Linkage Editor control card errors 
and correct them, uSing the applicable SRL. 

Stop any program at any given instruction of any phase. 
Effectively use all service aids for problem determination. 
Within the resident supervisor, locate and fix any failing 
instruction or routine. If unable to fix, circumvent when 
possible or advise the user of the temporary restriction, then 
use the correct trouble reporting procedure. | 

Prepare the necessary control cards to link a specific program 
into the CI library. 

Correct any coding errors associated with pre-SYSGEN planning and 
determine the necessary SYSGEN and program options to properly 
install and verify an SCP to match the user's systen. 

Obtain a SYSVIS file printout and locate any desired instruction 
or routine. 

Determine the key symptoms and conditions required to formulate 
an effective PASS search argument. 

Coordinate and monitor the activity on a reported problem to 
ensure continuous progress towards the resolution of the problen. 
Apply sound business decisions based on accepted business 
practices to billable calls, problem determination, and to 
resolution of customer situations. 


The preceding statements generally describe the responsibilities and 
skills required of a PSR in a DOS/VS environment. For more detailed 
information on the specific skills required to satisfy any one of the 
stated skills, refer to the objectives at the beginning of each topic 


in the course. 
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MATERIAL REQUIRED 


Your instructor will provide you 
required to complete this course. 


with 


all 


the 


necessary 


materials 


LTNFORBATION FOR THE STUDENT 
This manual consists of the following sections. 


1. General Information - Included are the basic skills for this 
course. These are statements of what is expected of the student 
on completion of the course. 


2. Course Layout - This is a day-by-day breakdown of the recommended 
sequence of presentation for all topics in this course. Teaching 
locations may possibly vary or deviate from this schedule (at 
their own discretion) as new information relative to DOS/VS 
becomes available, or as local conditions dictate. 


3. Student Outline - This section contains learning material for 
every topic in this course. Each topic has listed objectives, 
troubleshooting hints (if applicable), reading assignments and 
self-evaluation questions that test the student's knowledge of 
the listed objectives. 


4. Laboratory Projects ~- This section contains all available lab 
projects that can be completed during this course. Some are not 
required. All optionals are so noted in the Course Schedule. 


5. Trouble Analysis Problems - This section contains all available 
T/As for this course. All T/AsS are not required to be completed. 
The optional T/As are noted in the Course Schedule. 


6. Work Projects - This section contains all the work projects’ to 
be completed during this course. These projects are basically 
"paper projects" which can be completed through the use of 
reference material provided in the course. System availability 
or utilization is not required for completion of these projects. 


Te Problem Determination Techniques - This section (Appendix B) 
contains a collection of commonly used troubleshooting techniques 
(hints) that can be employed when analyzing a programming 
problen. The student should become familiar with these 
techniques and use them throughout this course. 


This manual was created as an aid to help the student reinforce 
lecture information and increase the knowledge gained from this 
course. To benefit from it, this manual MUST be used throughout the 
course. | 


If you have any questions, do not hesitate to consult your instructor. 
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COURSE LAYOUT 
DOS/VS BASE - CC 10639 


DAY 1 DAY 2 DAY 3 DAY 4 DAY 5 


REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY 


CONCEPTS OF A 
PROGRAMMING _/ DOS/VS PROCEDURE SYSRES ORGANIZATION RMS AND DUMPS oa PIOCS ee 
SYSTEM LIBRARY —s 


DOS/VSCONCEPTS —~ DOS/VS POWER ~~ RMS AND DUMPS a PIOCS ~~ PIOCS MESSAGES we 


DOS/VS OPERATING BUSINESS PRACTICES 
PROCEDURES (See NOTE 3) 


muvucd7Atomr 


Y LP 1 LP4 LP5 LP9 LP11 
is VM FAMILIARIZATION PROCEDURE LIBRARY DISK FORMATS DOS/VS BUG SYSTEM DISK READ AND PRINT 
(See NOTE 1) (Optional) 
LP2 LP6 LP7 . LP10 
VM SPOOLING POWER OPERATION LABEL EXTERNALS PIOCS MACROS 
t § (See NOTE 1) 
A € LP3 LP8 LP11 


B § DOS/VS | INTRODUCTION TO DISK READ AND PRINT 
FAMILIARIZATION LABEL PROCESSING (Optional) 


* 


TA1to5 “ TA1to5 LP 16 to 18 TA 6 to 11 TA 6 to 11 
OPERATING OPERATING RMS (See NOTE 2) RIOCS RIOCS 
PROCEDURES PROCEDURES ee xa 


APPLICABLE ONLY WHEN VM/370 FACILITY IS AVAILABLE AT TEACHING LOCATION. 


DEFERRABLE - MUST BE COMPLETED BEFORE DAY 10. 
THIS TOPIC CAN BE SCHEDULED AND ADMINISTERED AT THE DISCRETION OF THE TEACHING LOCATION. 
THERE IS NO INFORMATION RELATIVE TO THIS TOPIC CONTAINED IN THE DOCUMENTATION FOR CC10639. 


TTTX 


Wep 24 sep TMK Qs Sep 


REVIEW PREVIOUS DAY 
LINKAGE EDITOR VA 


e Control 
Statements 


e Operation Vs 


LP12 
LINKAGE EDITOR 


LP16 to 18 
RMS (See NOTE 2) 


REVIEW PREVIOUS DAY 
QUIZ 1 AND REVIEW Ve 


Programming 
Services 
Activity 
Report 

(See NOTE 3) 


LP16 to 18 
RMS (See NOTE 2) 


COURSE LAYOUT - CC 10639 Cont'd 


REVIEW PREVIOUS DAY 


VIRTUAL STORAGE \~ 
CONCEPTS 


VIRTUAL STORAGE 
MACROS 


LP13 
VS MACROS AND 
S/370 INSTRUCTIONS 


REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY 


SERVICEABILITY AIDS SCP INSTALLATION 


e PDAID @ RESPONSIBILITY 


DOCUMENTATION AND e PLANNING 
OLTEP 

e PIDSYSTEM 
PROGRAM SUPPORT 
RESOURCES 


LP20 
SCP INSTALL RESEARCH 


LP15 
OLTEP AND PDAID 


LP21 
SCP INSTALL 
PID SYSTEM RESTORE 


’ LP22 
| SCP INSTALL 

LINK AND DELETE 
SYSTEM COMPONENTS 


TA 12 to 14 
OLTEP 
(See NOTE 4) 


NOTE: 4. TAs 12 and 13 are MANDATORY. The remaining TAs on this page are optional at the discretion of the teaching location. 


ATX 


mavcaAoamr 


wpe 


REVIEW PREVIOUS DAY 


ACCOUNT 
MANAGEMENT 
(See NOTE 3) 


INITIAL PROGRAM 
LOAD (IPL) 


LP 20 to 22 
SCP INSTALL 


WPO want yh 
IPL 


V 


rap 17 
IPL 


(See NOTE 5) 


NOTES: 5. 


REVIEW PREVIOUS DAY 


SCP INSTALLATION 


e LIBRARIAN 
PROGRAMS 

e SUPERVISOR 
GENERATION 


LP23 
PTF SELECTION 


LP25 

SCP INSTALL 
SUPERVISOR 
GENERATION 


LP32 
ESERV 
FAMILIARIZATION 


REVIEW PREVIOUS DAY 
SCP INSTALLATION 
e INSTALLATION 
VERIFICATION 
PROCEDURES 


JOB CONTROL 


LP 23 & 25 
SCP INSTALL 


LP24 
SCP IVP ASSEMBLY 


WPO (PART 2) 
JOB CONTROL 


TA 18 to 21 
JOB CONTROL 
(See NOTE 5) 


REVIEW PREVIOUS DAY 
SCP INSTALLATION 


e POWER GEN 
e UTILITY 
PROGRAMS 
SERVICEABILITY AIDS 
e SDAID 
e SYSVIS DUMP 


LP26 
SCP POWER GEN 


LP14 
SDAID 


LP19 
SYSVIS DUMP 


REVIEW PREVIOUS DAY 


QUIZ 2 AND REVIEW 


INTERPERSONAL 
SKILLS (IPS) 
(See NOTE 3) 


LP14 
SDAID 


LP27 
SCP INSTALL SYSGEN 


LP28 
SCP IVP RUN 


LP29 

SYSRES 
REALLOCATION 
(Optional) 


TAs 15, 16, 18, and 19 are MANDATORY. The remaining TAs on this page are optional at the discretion of the teaching location. 


AX 
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COURSE LAYOUT - CC 10639 Cont'd 


Suv“. 
DAY 16 ~ DAY 17 DAY 18 DAY 19 DAY 20 


REVIEW PREVIOUS DAY REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY 


SUPERVISOR 


SUPERVISOR SUPERVISOR SUPERVISOR | SUPERVISOR 


e INTRODUCTION e TASK | e CHANNEL e ERROR oa e@ MCAR/CCH YY“ 


IPS (See NOTE 3) 


SELECTION SCHEDULER AND RECOVERY 
1/0 INTERRUPT PROCEDURES 
ROUTINES 


LP 27 to 29 va LP 27 to 29 ea LP 27 to 29 ea LP 27 to 29 of LP 27 to 29  . 


SCP INSTALL 
WP 1 

(See NOTE 6) 
TA 22 to 24 


SUPERVISOR 
(See NOTE 7) 


7 


SCP — SCP INSTALL SCP INSTALL SCP INSTALL 
ria | 
WP3 UL’ WP4 ve WP5 


WP2 


SUPERVISOR INTRO” TASK SELECTION CHANNEL SCHEDULER ERROR RECOVERY MCAR/CCH 


(See NOTE 6) (See NOTE 6) (See NOTE 6) (See NOTE 6) 


TA 25 to 29 TA 30 to 34 TA 36 to 38 TA 39 to 40 
TASK SELECTION CHANNEL SCHEDULER ERROR RECOVERY MCAR/CCH 
(See NOTE 7) (See NOTE 7) (See NOTE 7) (See NOTE 7) 


WORK PROJECTS (WPs) MAY OPTIONALLY BE COMPLETED DURING HOME STUDY. 


TAs 22, 24, 25, 29,30, 33, 36, and 39, are MANDATORY. The remaining TAs on this page are optional at the discretion 


of the teaching location. 
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COURSE LAYOUT - CC 10639 Cont'd 


DAY 21 DAY 22 DAY 23. DAY 24 DAY 25 


REVIEW PREVIOUS DAY REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY 


SUPERVISOR SUPERVISOR PAGE MANAGER PAGE MANAGER SUPERVISOR 


e FETCH TASK VA e TIMERS SL e PAGE MANAGER e PAGE e CCW TRANSLATION 


CONCEPTS AND REPLACEMENT 
e@ Shared QUIZ 3 AND REVIEW TABLES ALGORITHM e RESOURCE 


Virtual | MANAGEMENT 
Area @ INITIALIZATION e LOAD LEVELER 


e SERVICES e OPTIMIZATION 


WP7 WP6 WP8 wP9 WP 10 

FETCH/LOAD INTERVAL TIMER AND PAGE MANAGER. PAGE REPLACEMENT CCW TRANSLATION 
(See NOTE 6) EXIT MACROS (See NOTE 6) ALGORITHM AND LOAD | (See NOTE 6) 

WP 12 (See NOTE 6) LEVELER 

SVA AND STOW TABLE | TA 51 & 52 (See NOTE 6) TA 60 to 63 

(See NOTE 6) PAGE MANAGER CCW TRANSLATION 


(See NOTE 8) TA 53 to 58 (See NOTE 8) 
TA 42 to 49 | PAGE MANAGER . 
FETCH AND SVA | (See NOTE 8) ENVIRONMENTAL TAs 
(See NOTE 8) (See NOTE 3) 
| ENVIRONMENTAL TAs 
(See NOTE 3) 


NOTES: 8. TAs 42, 45, 48, 49, 51, 53, 55, 58, 60, and 62 are MANDATORY. The remaining TAs on this page are optional at the 
discretion of the teaching location. 


Pi 


~COURSE LAYOUT - CC 10639 Cont'd 


DAY 26 DAY 27 DAY 28 DAY 29 DAY 30 


REVIEW PREVIOUS DAY REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY 
QUIZ 4 AND REVIEW LIOCS : LIOCS a LIOCS LIOCS 


| SUPERVISOR @ Introduction we @ Tape Files 4 e SD Files e DA Files 
‘MISCELLANEOUS Je ae ; 
e DASD FILE e Unit Record ye @ Tape Labels e SD Labels e DA Labels 
PROTECT 
e SEEK SEPARATE | e@ ISAM Concepts 
e SYSTEM FILES | 
ON DISK 


TTAX 


WP11 LP30 1” | ips ee WP13 


SYSTEM FILES ON UNIT RECORD MACROS | TAPE LABELS INDEXED SEQUENTIAL 
DISK (See NOTE 6) FILE ORGANIZATION 
LIOCs TAs | (See NOTE 6) 


ENVIRONMENTAL TAs (See NOTE 9) 
(See NOTE 3) | | 


TA 101 to 105 TA 106 to 108 TA 109 to 115 TA 116 to 120 
UNIT RECORD MACROS | TAPE MACROS SEQUENTIAL DISK DIRECT ACCESS 
(See NOTE 10) (See NOTE 10) ~ MACROS MACROS 

| (See NOTE 10) (See NOTE 10) 


NOTES: 9. All s rashes (dumps) and program assemblies are contained in DOS/VS Base SCMs 2 and 3 respectively. 
10. TAs 101, 102, 103, 106, 107, 109, 111, 114, 116, 118, and 119 are MANDATORY. The remaining TAs on this page 
are Optional at the discretion of the teaching location. 


COURSE LAYOUT - CC 10639 Cont'd 


REVIEW PREVIOUS DAY REVIEW PREVIOUS DAY | REVIEW PREVIOUS DAY 
LIOCS LIOCS QUIZ 5 AND REVIEW 


e ISAM e DISK WORK FILES VISIT BY FIELD 
IMPLEMENTATION SUPPORT REP 
e DEVICE (See NOTE 3) 
@ ISAM INTERNALS INDEPENDENT 7 
FILES | e CHECKPOINT/RESTART 


mouocaaomr 


e SPANNED 
RECORD 


WP 14 CHECKPOINT/RESTART 
SPANNED RECORDS (See NOTE 12) 
(See NOTE 6) 
COMPLETE ALL 
i | UNFINISHED LPs, 
A WPs, and TAs 
B §TA 121 to 125 TA 121 to 125 
ISAM MACROS ISAM MACROS | | 
(See NOTE 11) (See NOTE 11) 
ENVIRONMENTAL TAs | ENVIRONMENTAL TAs ENVIRONMENTAL TAs 
(See NOTE 3) (See NOTE 3) (See NOTE 3) 


. TAs 121, 123, and 124 are MANDATORY. The remaining TAs on this page are optional at the discretion 
of the teaching location. 
Non-lecture topic - tutorial reading is contained in DOS/VS Base SCM 1. 


TITAX 


STUDENT OUTLINE 


CONCEPTS OF A PROGRAMMING SYSTE 


ORR aD 


This topic introduces the basic concepts of a programming systea. The 
components used in DOS/VS and the concepts of symbolic addressing, 
multiprogramming, and POWER are also discussed. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be. able to: : 


if Vs Determine whether a program in a given list is a control program 
or a processing progran. 
“2s Place in the correct sequence the steps required to implement a 
«program. 
\/3- Identify the purpose of the following programs when operating in 
the DOS/VS environment: | 
IPL 
Job control 
Se | | Supervisor 
| | Assembler 
Linkage editor 
/ Identify the correct sequence of operation and interaction bet 
tween the following programs when executing an assembly: 
IPL | 
Job control 
Supervisor 
Assembler 
: Linkage Editor 
/5- Identify the operation of job control when processing an ASSGN 
statement as it relates to the logical unit block (LUB) and 
physical unit block (PUB). 
de State the purpose and advantages of both a multiprogramming and 
POWER operating systen. | 7 | 


Highlights 


SA -System control programs consist of: | 
IPL 

Job control 

Supervisor 

POWER 
IPL initializes the system and loads the supervisor. 
Supervisor is core resident after IPL and acts as a monitor for 
all other programs. 
Job control is in core between job steps and provides job-to-job 
transition. | | 


< %% 


x The linkage editor is a service program and prepares object 
programs for execution. 

Ss SYSRES contains all programs to be executed by DOS. 

v4 Multiprogramming provides the facility of several programs 
operating in core at the same time. 


Activity 
IN: Introduction to DOS/VS 
READ: Part 1: What is a Disk Operating System 
Part 2: The Functions and Facilities of DOS/VS 
through 
Libraries 


SELF-EVALUATION QUESTIONS 


Vas Below is a list of programs. Place a P next to the pro- 
cessing programs and a C next to the control programs. 


ae ---£ COBOL 

De == Linkage editor 
Cx ----5 IPL 

Ge won > SORT 


e. ae Supervisor é& 


f. ---4+- Job Control 
d.. === p PL/I 
he. —----+ POWER 
Ze Arrange the following items in the correct sequence to 
execute a program. 
a4. === Linkedit time 
b. ----“ Execute time 
Ce. ~----7%Code source program 
d. ------lCcompile time 


3. Match the following programs with their associated function. 


Ae tb -- Loads the supervisor ue IPL 

b. 7 eo Loads job control Zs Job control 

Ce -_* Loads linkage editor 3. Supervisor 

d. - Translates symbolic to 4. Assembler 
machine language Dis Linkage editor 


e. -TfL-- First DOS control program 
loaded into the system 

f.0 c23-- Converts object module 

LK from language translator 

output to executable format 

g. -#tb- Resides on SYSRES 

h. -36-- Is a service program 

i, -%0- Provides job-to-job 


transition 
ts -SVAL Handles I/0O operations 
4. Number the following programs according to the sequence in 


which they are loaded into core when the system is IPLed and 
a program is assembled. 


a. -----2Supervisor 
b. -----4 assembler 
cs. === IPL 
d. -—-----4Job control 
@ 5. The ASSGN statement changes the pointer in the: 
a. PUB 
b. LUB 3 
Cs Job Control Program 


d. IPL program 


6. The hardware address of an I/O device is located in which of 
the following: | 


as PUB 

b. LUB 

C. Job Control 
d. IPL 


10. 


The LUB and PUB is located in the — _ program. 
ae IPL 

b. Job Control 

Ce Supervisor 

d. SORT 

e. RPG 

To operate a BuSts PEOgrenning system, it is necessary to 
have at least _. partitions. 

Ae 2 

be 3 

Ce 1 

d. 4 


(True/False) Partition priorities are necessary to determine 
in which sequence each will he serviced. 


(True/False) All unit record I/0 instructions in the prob- 
lem program are modified to disk I/O instructions when 
using POWER. 


Refer to the Contents for the location of the self-evaluation question 
answers. 


DO S_CONCEPTS 


This topic introduces the disk operating system operating environment. 
The use of symbolic names for I/O devices used by IBM programs is 
explained and examples given. The components of the DOS/VS system are 
presented and the controlling of these components through the use of 
control cards is introduced. The specifics of the IPL and JOB CONTROL 
error messages will also be discussed. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: | 


1, Correct any errors in Job Control cards used to do an assembly, 


a linkedit, and execution of a problem program (excluding label 
cards). 
pe Use the error messages printed out on the console, and the DOS/VS 
vA Operating Procedures Manual to correct any operator error 
encountered during the assembly and execution of a problen 
progran. 


/3- Use the DOS/VS MGMT guide to determine what symbolic units are 
required by the ASSEMBLER progran. 
Waa Use the system message to locate the cause of the cancellation on 
a given system dump. 
@ of 3 Use the linkage editor map to locate any instruction of a problem 
i: program, given a storage print. 
Hee. Locate the following when given a standalone or system _ storage 
print: 
General registers 
CAW 
CSW 
PSWs (old) 
PSWs (new) 


Highlights 


A // JOB card indicates the beginning of a job and another // JOB 
or /& signals the end of a job. 

A job contains one or more job steps. | 

All IBM Programs require specific symbolic units. 

OIXX messages pertain to IPL errors. 

1XXXX messages pertain to JOB CONTROL errors. 

Low core information (System Dumps) supplies valuable information 
in problem determination. 


Troubleshooting Hints 


@ Use the DOS/VS Messages Manual to determine the meaning and 
corrective action for all messages. 
e Use the DOS/VS System Management Guide to determine the symbolic 
units necessary for operation of the ASSEMBLER program. 
e Use the linkage editor map to locate a program in storage at 
execute time. 
Activity 
IN: DOS/VS Operating Procedures VUY 
UNDER: Operator Commands p 4s gifs 
READ: IPL Commands g(-pte 
Job Control Commands pl AS 
Attention Commands 
(4 ADD Command 
ALLOC Command 
ALLOCR Command 
ASSGN Command 
CANCEL Command 
DEL Command 
DPD Command 
DUMP Command 
EXEC Command / 
MTC Command 
PAUSE Command 
lf} SET Command 
READ: IPL Procedures , _ 
(Procedures 2 and 4) 3 DOC tow 5 ps2 2 
IN: DOS/SSADP 
UNDER: Serviceability Aids (Section 2) 
READ: Low Address Storage | Ady ei 
Wait State Messages AIH -DWaF Re,PN 
Linkage Editor Map Liyl 
UNDER: Operator Commands (Section 2-A-1) 
READ: The DUMP Command isi 
b cov HOO 
IN: DOS/VS Messages 
UNDER: 01XX Messages (IPL) TL xxx 
READ: Introductory Information N 
UNDER: 1-Prefix Messages (Job Control) WW 
READ: Introductory Information 


1A0nD Message Meaning 


SELF-EVALUATION QUESTIONS 


1. The job control program is the unit in the disk operating system 
that handles job-to-job transition. It does which of the 
following: 


ae, reads job control cards from SYSIPT. 


Yr b. is disk resident and must be loaded into core whenever its 
functions are needed. 
Ce is core-storage resident and its functions are requested via 
~b an SVC (Supervisor call instruction). 
d. is loaded, as a deck of cards, from the reader, and in turn 
yw loads the Supervisor from a disk pack. 
 taat 
2s At the time execution of a processing program is requested, it, 
like all programs run under control of the disk operating systen, 
is; 
a. resident in core storage at all times. * ~ 
b. a module in the relocatable library. vw 
Ce loaded, by the system loader, from SYSIPT. 
d. relocated, loaded and executed by the linkage editor. 
e. fetched from the core image library. 
3 Select the required cards and decks from the following list, and 
place them in sequential order to do an assembly, linkedit, and 
@ execution of a problem progran. 
--- a. // JOB TEST | 2¢R TST 
--- b. // ®XEC LINKEDIT 4, Yr LN ee 0) 
en “ is anne or / ER ASUNELY 
me . / ION LINK Ga 
= 3S, Object Deck _Suwece | 
--- £. /6 B10 ee = 
Se Gs Source Deck 4+ ff EXEC LIKE DT 
-~-- h. // EXEC ASSEMBLER & ‘Oni 
ae Data Deck 8 7 
--- je. /S/ EXEC | 
--- k. // EXEC ASSEMBLY t, jf ¥XEC 
--- ll. /S/ EXEC TEST SK 
=—<—= Ms // EXEC LINKEDIT A 


4. The message 0SO3I indicates that the program was aborted due 


ae An invalid SVC. 


b. An invalid logical unit. 
Cx A channel program check. 
d. A program check. 
e. None of the above. 
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10. 


Under DOS/VS, the terms "job", “job step", and their inter- 


relationship may be most accurately described as: 


ae A "job" is one or more related job steps run as a unit. It 
is initiated by a // JOB card, and terminated by a /* card. 

b. A "job step" is a series of related jobs. 

Cs A "job step" is the execution of one processing program. It 
is initiated by the // JOB card. 

d. A “job" is one or more related job steps run as a unit. The 

/ unit is initiated by a // Job card and terminated by a /& 
card. 

ee None of the above. 


The storage location of a problem program at execute time can be 
determined by using the __ LiINKCOIT MAP : 


The IBM __ (standalone/system) dump formats the PSWs. 


(True/False) When a standalone phi print is taken, DOS does 


not have to be re-IPted. IVORY, Horr, eyo 


Certain operating conditions, options, etc, that the DOS/VS 
assembler operates under may require that various symbolic units 
be assigned. However, under all conditions of operation, the 
assembler requires certain units be assigned. They are: 


Wa. SYSRDR, SYSIPT, SYSLST, SYSPCH,: SYSO001, SYSO02, SYS003 


b. SYSIPT, SYSLST, SYSPCH, SYSO00, SYS001, SYS002, SYS003 
Ce SYSRDR, SYSPCH, SYSLST, SYSO00, SYSO001, SYS002, SYS003 


La. SYSRDR, SYSLST, SYSIPT, SYSLOG, SYSO01, SYS002, SYS003 


<i SYSLOG, SYSRDR, SYSIPT, SYSLST, SYSO00, SYSO001, SYS002 


Assume the operator was running a job and it was cancelled due to 
a program check. There was no system storage print outputted on 
SYSLIST. Which of the following is the most likely cause of no 
system dump? 


a. SYSLST unassigned. wmlol be lunge 

b. The printer is inoperable because of print checks. “UM 

Cx There was a disk error when the storage print program was 
being loaded in core. \SVM.. 


a. There was no // OPTION DUMP job control statement. 


Refer to the Contents for the location of the self-evaluation question 
answers. 


DOS/VS_ OPERATING PROCEDURES. 


Operating procedures for the DOS/VS are presented in this topic. 
Basic IPL and Job Control communications are also discussed. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


Vs Operate the IPL and JOB CONTROL programs of DOS/VS system to do 
an assemble, linkedit, and execute. 

2« Use the error message printed out on the console, and DOS/VS 
Operating Procedures Manual to correct simple operator errors 
encountered during the assembly and execution of the problem 
progran. 

3 Use the console and proper JOB CONTROL statements to obtain a 
system dump, either during execution or on an abnormal ternmin 
nation of a problem program. 

QW. Identify the partition that issued the message, given a message 
from DOS/VS. 

oe Use the error message that resulted from an incorrect JOB CONTROL 
Statement, to locate the failing operand. | 

6. Identify, given a DOS/VS error message, the action indicator, 
message number, and program that issued the message. 

Tas Determine the course of action to be taken when the system enters 
a wait state with no message printed. 


Highlights 


@ IPL statements can be read from SYSRDR or the operator console. 
e Symbolic device addresses can be changed with the ASSGN 
statement. | 
® // ASSGN is a temporary assign and is in effect only for a job. 
€ The // EXEC card with operand causes that program named in the 


operand to be executed from the core image library. 


Troubleshooting Hints 

e Use the LISTIO command to determine the symbolic assignments of 
the systen. | 

® Error messages can occur in low core, on the operator console or 
on SYSLST. | 

@ Always use the operator's guide to determine what a message 


really means and to make the correct response. 


io gw dabeh de 
EXT tril — fet hewn LVC [> poral Wh 


LBC — Shag jw label prresins 


A Lah Td. 


Activity 
IN: DOS/VS Operating Procedures 
READ: J \F -Control Programs me (PLL SP SUL 
Fae -Symbolic Device Assignment hg Mo. 7YUjUG. 
“ @%§ -IPL Procedures (Section 3) | 
of _ ~Job Control Functions 
(4y" -~gJob Statements and Examples Artt lape 
| -OPTION Statement | thee 
Is$_(4} -ASSGN statement Slut, 1 Label mt STOLE TH 
IAL -EXEC Statement ated: al nif | 
‘plo _/* Statement mim) AST —~ grt ul Dit a 
, ~f/& Statement pth Stands 
\%8. -SET Statement-IPL Statement 
lex -DPD Statement-IPL Statement C foe -rp) 
63 -Starting the Systen A orion peyCS70 
file. 
IN: DOS/VS Messages é 
-Preface Page thas tke 
-The Message Code 
IN: Ad DOS/VS Serviceability Aids 
| and Debugging Procedures 
READ: -WAIT State (Coded Messages) 


-WAIT State (During IPL) 


SELF-EVALUATION QUESTIONS 


1. 


IPL is one of the control programs in 
certain initialization functions such as: clears core storage, 
assigns a physical 1/0 device to SYSRES, loads the supervisor 
nucleus, etc. IPL does which of the following? It: 


DOS/SVS. It performs 


Sel te resident on disk and its functions are requested by 
addressing the resident device and pressing the load key. 
b. xX Is loaded from a card reader. 


c. x Is loaded from disk every time a program reaches EOJ (end- 
of- job). 
d. x Is loaded from disk every time a program is abnormally 
terminated. 
e. } Is core storage resident, and its functions are requested 
via an SVC. 
The system is IPLed and the reader is made ready. One card is 


read and the enters the wait state. Your next action 


should be to: 


‘a 


a. / Check bytes 0-5 for an error message. 


system 


b. Run diagnostics on the reader. 

Cz Run diagnostics on the disk. 

d. IPL again. 

e. Check the console switches to determine if you have [PLed 


the correct device. 
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i Given the following job control statement and error message, the 
' operand in error is: 


‘, 


F 
ASSiGN\ S¥S003,X'181" 


BG 1S01D 
ae 1 
b. 2 
Ce 3 
qd. 4 + 
e. 5 


¢ 


Use the following DgS/vs error message to answer questions 4, 5, 
and 6. ' ‘ 
v's 


F1 10521 


4. The program that issued the above message is: 


ae IPL 

b. Job Control 
Ce Supervisor 
d. POWER — 

e. Sort 


Ds The partition that issued the above message is: 


® a. -Background 
| b. IPL 
Ce Job control 
d. Supervisor 
e. None of the above. 
6. The action indicator in the above message indicates: 

Ae Action 
b. Information —~ 
Cs Decision 


te The system enters a wait state with no message printed. Low 
core (0-3) contains X'07E60190'. This indicates: 


ae Machine check 

b. Channel failure 

Ce Program check in the Supervisor 
d. IPL error,” 

e. I/0 Error queue overflowed 


11 


The proper action to be taken from the error in question 7 is 


_ Oa. 


8. 


Refer to the Contents for the location of the self-evaluation 
question answers. 
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DOS/VS_ PROCEDURE LIBRARY 


,This topic introduces the student to the Procedure Library contained 


in DOS/VS. It will cover the method of developing the library and how 
it is utilized and nodified. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


ae State the method used to catalog a procedure in the Procedure 


Library. CATALP : 

2. Describe the purpose of overwrite statements. cv avin 

or Develop the overwrite statement(s) necessary to change or add_ to 
a cataloged procedure. ABD M 


WY. Define Partition-Related Procedures and the method used in DOS/VS 
to process then. 


Highlights 


Set up at SYSGEN time 

Basic and Extended support 

Ability to change cataloged procedures (overwrite statements) 
Library maintenance facilities available 

Partition-Related cataloged procedures enhancement 

Inclusion of In-Line SYSIPT in procedure 


Troubleshooting Hints 


® Interrogate all messages for clues to a procedure problen. 
e Display the Procedure Library using the DSPLY function. 
® Determine what a given program procedure is attempting to do. 
@ Build overwrite statements to correct/modify a given procedure. 
Activity 
INS: DOS/VS Operating Procedures . 
UNDER: Using Cataloged Procedures ~~ 
READ: Cataloging a Procedure a 
Ms Including a Procedure in the Job Stream — 


Modifying a Cataloged Procedure — 
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IN: DOS/VS System Management Guide 
UNDER: Using the Libraries (Chapter 7) 
READ: Maintaining the Libraries 4.4 
Cataloging the Procedure Library j;4.]| CAYEUP 
Deleting a Procedure A? 44 
Condensing Pi 
Reallocating (up to Renaming)? It 3.0¢ 
UNDER: Controlling Jobs (Chapter 5) 
READ: Partition-Related Cataloged Procedures 
SELF-~EVALUATION QUESTIONS 
Vs To catalog a procedure in the Procedure Library, which of the 
following statements are required: 
--- a.  CATALP — 3 
-~=-- hb. ASSGN 
--- c. EXEC MAINT — 2 
--- d. TLBL ~ = 
--~- @, /+* uw Y- 
-~-- f. JOB ANYNAME w Jd 
--- g. EXEC (PROCNANE) 
--- h. /* a gs 
--- i. £6 a 6 
2s To have the ability to change a cataloged procedure, 
overwrite statement must have a symbolic name in col ___ 
a code incol _ are 
Ae 80, 73-79 
b. 73-79, 80 
Ce No symbolic name or code needed. 


3. (True/False) SYSIPT data read from the Procedure Library 
modified by overwrite statements. 

4. To modify (alter) a statement during execution of an 

procedure that is 


Enp = 22, OAAYEO 


the 


_ and 


be 


existing 
cataloged in the PROC library, the overwrite 


statement must contain which of the following codes in column 80? 


ae D 
b. B 
oe Blank or M — 
d. A 
5. (True/False) An unnamed statement in a cataloged procedure cannot 


be modified by an overwrite statement. 


CINDL. t= 20 


bay Chdlevnae. 
ore err 6 


Mar stivd Lyrae  SHSTOm )UGCTOMY 


_— gre SERN 


6. A procedure called PAY has been cataloged in the PROC library so 
that it can be executed in any partition (Partition-Related). To 
execute this procedure in the BG partition, the EXEC statement 
would contain which of the following: 


a. // EXEC PROC=PAY 
b. // EXEC PROC=$PAY 
c. // EXFC PROC=$BPAY a ol . dog tte 
da.  // EXEC PROC=$$PAY —— hy bey Mypler TR tary Jape AYAY Col 


nna | 4 Atay ay f J aw whe fe ora 
ud )) mm y yp ye | iP 
7. (true/False) When the EOP parameter is omitted in CATALP 


Statement, /* can be used as an end-of-data delimiter in the 


Tp. cataloged procedure. feegust “4 taut? (Aizen Hf kDT 


8. The support required to allow in-line SYSIPT data to be processed 
is: 


ae Basic 
b. Extended 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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INTRODUCTION TO DOS/VS POWER 


This topic introduces DOS/VS in a POWER ENVIRONMENT. It includes the 
philosophy and operation of POWER including the commands necessary to 
start, stop, and modify the operation. Partition priorities are re- 
emphasized and the JECL statements to change job priority within the 
associated queues for the partition are discussed. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 
1. State the advantages of using POWER. rare) fle) 
2 Given a job stream, determine the priority of job execution in a 
POWER environment. | 
i Use the Queue Management console commands to: 
ae Determine the status of any job in the POWER System. 
b. Hold a job in the INPUT Queue. 
Cs Release a job from the INPUT Queue, 
4. Prepare the POWER JECL statements that are required to execute a 
job with the following conditions: 
a. Execute a job in the BG partition 
b. Assign the highest priority to the job 


Highlights 


® POWER increases job throughput. 
e Unit record I/O is performed at disk opeeas during job execution. 
@ Up to four (4) partitions can be serviced by POWER. 
© POWER JECL statements provide the facility to: 
= assign priorities to jobs. 
~ put jobs in the HOLD state. 
7 spool output to tape instead of disk. 
= specify the partition a job is to execute in. 
= prevent spooling of output. 
@ POWER Console Commands provide the facility to: 


= display the status of jobs in the Queue. 
= alter the priorities of jobs. 

= put jobs in the HOLD state. 

= delete jobs from the Queue. 

- release jobs from the HOLD state. 


® Determine whether the program only fails in a POWER environment. 
e Use charts in SADP manual, Section 3, that relate to POWER 
operations for problem determination. 
® Display the Queues to determine the status of the Input, Punch, | 
and/or Print queues. © 
© Investigate all POWER messages involved with an error. 7 
16 
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@ To read more job streams from SYSRDR after it has run out, press 
the REQUEST and END keys. 

@ Change partition priorities if possible when running diagnostics 
to speed up input/output processing. 

© If restarting POWER is necessary, the response to the message 


FORMAT QUEUES? should be an EOB/END to prevent formatting the 
DATAFIL and QFILE and consequent loss of data (If possible, have 
customer start up POWER). 


Activity 
IN: DOS/VS Operating Procedures | 
UNDER: Concepts and Components of DOS/VS * T BTS 
READ: POWER $2 34Ud 3% my 
UNDER: Using POWER 34 
READ: fp Initializing POWER 
; Starting a POWER-Supported Partition 
, Issuing POWER Commands 
ge, Terminating POWER 
UNDER: POWER Commands (Routine and System Management) 
REVIEW: f START 
, STOP 
@ | CANCEL 
¥ DISPLAY 
4, TERMINATE 
UNDER: POWER Commands (Queue Management) 
REVIEW: ho ALTER 
DISPLAY 
» HOLD 
114 RELEASE 
IN: DOS/SVS SADP 
UNDER: Hard wait with Message in Low Address Storage 
(Chart 03, part 1 of 1) 
= Check 1 
= Check 14 


(Charts 13, 2 parts) 
= Checks 1 through 4 
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SELF-EVALUATION QUESTIONS 


Use the following job stream as a reference to answer 
questions 1 and 2. 


* $$ JOB A,H,3,F2 
i 
1. Which job will execute first when this job stream is read in- 

to the INPUT QUEUE? 

ae JOB A sha 

b. JOB LIST“  vler * bgt 4s 

Ce JOB SORT 


De What partition will JOB SORT execute in? 


Ae F2 | | 
b. BG MYyutkR. 6 Ls 
Cs F1 ' | 
3. Which one of the following commands would you use to deter- 


mine the status of the jobs in the F2 INPUT QUEUE? 


Ae DISPLAY F2RDR,ALL 
b. D F2RDR,ALL V4 
Ce D F2RDR, QUEUE 

d. D F2RDR,H 


18 


4, Which one of the following commands would you use to prevent 
any more jobs with a priority of 5 from executing in the BG 
partition? | 


ae H BGRDR,5U 
b. P BGRDR,- 
Ce H BGPRT,° 
d. H BGPUN, 


5. Which one of the following commands would you use to release 
all the jobs in the BG print Queue from the hold state? 


Ae R BGPRT,5 

b. R BGPUN,ALL 
Cs R ALL,BGPRT 
d. R BGPRT, ALL’ 


6. Which of the following statements is true for a job running in 
the POWER environment? 


ae The Punch Task intercepts the punch output and spools’ then 
to disk. | 

b. The Print Task is responsible for spooling output records to 
disk. | 

Ce More jobs can be processed in a given amount of time. ~ 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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SYSTEM RESIDENCE ORGANIZATION 


The system residence pack is the major component of a DOS/VS' systen. 
The components comprising the SYSRES pack are discussed as_ to 
location, size, purpose and format. These components will be 
referenced over and over again throughout the course, It is important 
to gain at least a talking knowledge of the system pack components at 
this time. Also included will be discussions of private libraries and 
label information required for disk. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


ls Identify the four libraries of a DOS/VS system residence file and 
the directories associated with each library. 

2 Give the fixed disk address assigned to each of the following 
system residence components: 
ae Core Image directory  4@¢201 
b. Volume label WO DOPE 
C. IPL records Naa aenenta 

36 Identify the library on the system residence or private pack fron 
which programs are executed by the DOS/VS system. 

4. Identify the library on the system residence pack wipere object 
decks from all IBM compilers can be stored. 

a Identify the library that can be used as input by the assembler 
or COBOL language translators. Sl. | 

6. Identify the DLBL and EXTENT parameters required to define files 


on disk. 
bis, MN, Lue FD, dal, Pope 
THT, sie, Hy 4,0, DW. 
Highlights 
® Four libraries may exist on SYSRES. They are the core image, 


relocatable, source and procedure. 


e SYSRES can be on a 2314/2319, 3330 or 3340. 
® Private libraries can be on anything except 2321. 
@ Private libraries can take many shapes. For example: 
= All privates on one pack. 
= Each private on its own pack. 
© SYSRES will always contain a core image library, but not 


necessarily a relocatable, source or procedure library. 
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IN: DOS/SVS System Control Statements 
UNDER: Job Control Statements and Commands 
READ: EXTENT pst 
XTENT p52. 
DLBL p24 
DLAB p24 
VOL ps) 
IN: DOS/VS Librarian Logic 
UNDER: pig System Residence Organization and Private Libraries 
READ: 19 System Residence Organization After Generation 


f to 
Ge Librarian Organization Program 


NOTE: The content of each directory entry, etc. is 
not important at this time. 
Concentrate on the use or function of all items. 


IN: DOS/VS Base SCM 1 
STUDY: System Residence Organization Section 
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SELF-EVALUATION QUESTIONS 


1. 


The figure below is a representative layout of a 2314 SYSRES 
file. Place in the various areas of the figure, the letter 
representing that area from the list below. 


Cylinder Cylinder One Cylinder 199 


V 
F p M t (f 
Cc 


0 
[FE 121549] 


Ss 


GO 


17 
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ae Core Image Library 

b. Relocatable Library 

Cs Volume Label 

d. Source Directory 

e. Core Image Directory 

£. Relocatable Directory 

Ge IPL Records 

h. Label Information Cylinder 
5 System Directory 

1. Volume Table of Contents 
k. User Area 

Le Source Library 

M. Procedure Directory 

ne Procedure Library 
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OB 


Programs are executed from the 


_. library. 


(True/False) The library sizes are determined by the 
customer. 


< 
The assembler looks in the _ Sh library if it encoun- 
ters a macro statement. 


Object p grams assembled by compilers may be stored in the 
Or feree sie _..._ library. 


The optional library (libraries) on the system residence pack 


are: 
oe 
fa) Source, relocatable ‘awa procedure. 
D. Relocatable, core image, and procedure. 
Cs Core image, source and relocatable. 
ds Relocatable, procedure, core image, and source. 
e. Core image, and procedure. 


There can be private libraries associated with which of the 
following libraries? 


ae Relocatable. 
Ds Core image. 
Cs Source. 


d. All of the above. \.~ 
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8. Study the following figure of a desired 2314 work pack layout. 
Then code the DLBL and EXTENTS following the figure. 


56-68 


SYS003 SYSLNK 
(4) ‘ 
yon. 


[FE 121550) 


// DLBL TISSO2 , "DOS. ss age ee 0,9 44/86 , 
// EXTENT SYSO01,111111, %,9 

J// DLBL Y4S48@2. , "DoS. WORKFULE. Be S02 4 9/SS ; 
// EXTENT SYS002,111111, § ,4 

// DLBL TASS@2 ,"DOS.WORKFILE.NO.3! AY ‘SDS 
// EXTENT SYSO003,111111, 474, 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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RMS AND DUMPS 


This topic introduces the methods and programs available to the PSR to 
extract data from a system that will be used in problem determination. 
It will include operator commands to alter, display, or dump and the 
method of generating a standalone dump program from the DUMPGEN 
facility. Concepts of wait state, error recording, and retrieval 
(EREP) are also covered, along with the use of operator and programmer 
flowcharts in the Serviceability Aids and Debugging Procedures Manual. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Identify the control cards and parameters needed for the DUMPGEN 
program, when given user specifications. 

Ze Interpret a formatted dump which was generated from the DUMPGEN 
program. 

36 Analyze all low core wait state messages. 

4. Identify the function of the options for the EREP program for 

DOS/VS. 

State the difference between a ‘soft' and a thard' machine check 

error. | 


Highlights 


® Formatting or non-formatting standalone dump programs tailored to 
system requirements can be generated through the use of the 
DUMPGEN progran. 


® Problem determination charts aid in determining a hard wait, soft 
Wait, looping, and incorrect results. 

@ The SYSREC file established at SYSGEN time records errors’ for 
both I/O and CPU malfunction. 

a EREP is used to retrieve error data from SYSREC in ae useable 
forn. 


@ Logout Analysis on the 370/125 and 370/115 is the vehicle to 
gather error data on all but channel connected devices. 


é ALTER, DSPLY, and DUMP are commands used to gather and modify 
system information and hard wait failures. | 
@ DUMPGEN produces a customized standalone program used to obtain 


a formatted/non-formatted dump of storage. 


Troubleshooting Hints 


@ Investigate all error messages and use SADP flowcharts wherever 
possible to assist in problem determination. 

& Utilize EREP to gather I/O related data on ‘hard' waits. 

cS) Interpret low-core messages. 

€ Obtain a core dump using the standalone program generated by the 


DUMPGEN facility. 
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pT 


& Run (SERED) if the low-core message contains a SEREP run request 
(£2) in Byte [T).. 

@ Néver use a standalone dump generated on another system, as the 
non-critical area of the Supervisor that DUMPGEN uses may be at 
different addresses. | 

daar eee 

Activity 

IN: DOS/VS SADP 

UNDER: Dumps of and i es_ t Boe ne Addresses 

READ: ie A ALTER AK NETER and Pl 

%9 9-4 DSPLY Ke 0b Seo ratte at 
2ie 2 DUMP 5, Ba, Fa, PDARER , Keno ~ xox 
fre 
READ: Voy. - Jf oor 3 Mon Statement = OF Welut« CANCEL! 
SYSTEM Dumps - a Wet eae 
RAW DUMPGEN & seandalous Dump 
2: anttathag 
UNDER: Hardware Error Recording & Recovery 
READ: aes General Description of RMS 2098 
ie Operation and ERPs for I/0 Devices %/4§ 
Y~a 4 SYSREC File “4 
EREP 2 We 
SEREP 2.2% 
READ: Section 4 (Debugging Procedures for 


the Programmer) wi 
-Flowcharts for Hard Wait State 
-Flowcharts for Soft Wait State Y 4 


Weta WrHT cm = in ) 


bP 2 


SELF-EVALUATION QUESTIONS 


Ve If the recording file is not ready at IPL time, the: 
a. Recording file will not be maintained. 
j, b..- Operator will be informed to put recording file online to 
~~ © continue. 
Ce Operator will be informed, but may hit EOB/END to bypass. 
ds Operator is not informed. 
Ls OPTION CLEAR specifies that the EREP frogram should: 
ae , Clear MDR records from SYSREC. 
be.’ Clear all records from SYSREC, and edit and print. 
Ce Clear SYSREC pack. 
d. Clear MDR and MCAR/CCH from SYSREC. 
(1 deg, amar 7 DB Nb loemay 
Vir aim 7 AME dm RAEN 


—-DSCEN-PIET X ODE S olget KCON SISIAT  X'ODF 
vind nomen s OPTION EAemr= Noy quhault 


Puliel bac 4- 3 Wwe _ eaes= 4 5 oghault OTN pom fies? 
% /. 


26 


5 ) 


3. The DOS command that must be given to ensure all error recording 
data is written on the error file before the system is powered 


down is: 

ae EREP 
b. IPL 

d. ROD 


a. A 'soft' wait on S/370 will Poneoue to the 


key on the 
typewriter console. : 


a.  EOB/END 
b. REQUEST 


Ce« IPL 
d. CANCEL 
Ce RETRY 


v 
ore (True/False) The PPOOL option for the DUMPGEN program defaults 
to NO if it is not included in the job stream. 


6. To have DUMPGEN produce a standalone dump on tape, you must: 


a. Code TAPEIPL=YES in an OPTN statement. 
b. Assign SYSLST to a tape drive. 
Ce Code INTR=YES in an OPTN statement, then when the sys- 
tem enters the WAIT state, make the desired tape drive 
; ready. 
vd. Assign SYSPCH to a tape drive. 


7. To get a dump using the DUMPGEN program that gives the supervisor 
tables and boundary box, the parameters that must be set are 


ED LP A CPOE SE EP A EE SAD ED aD eS 


Ae FORMAT=YES 
b. PPOOL=NO 
Ce FORMAT=NO 
d. INTR=YES 
VC PPOOL=YES 


8. (True/False) The original information in bytes 0 through 23 is 
destroyed when a dump is loaded into storage. 


9s Choose from the following list the error types that are cons 
sidered soft machine checks. 


===" dis Retry | 

mae Ds Storage Protect key failures 
—~- Ce. Multiple bit storage errors 
--- 4d. Single bit storage errors 
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10. The system is in a wait state with a low core message of 
X'*C8E2C9'. The appropriate action to take is: 


ae Run EREP. 


b. Ignore and continue processing. 
aCe Run SEREP. 
d. Issue the DUMP command. 


Refer to the Contents for the location of the self-evaluation question 
answers. 


(RQ “er € 
, yf \ 
i _ Syste prcrov pL 
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PHYSICAL INPUT/OUTPUT CONTROL SYSTEM (PIOCS) 


This topic introduces the concepts of the Macro System and presents 
the PIOCS coding (macro) employed in a problem program that will cause 
the issuance and testing of an I/O request. The need for specific 
PIOCS control blocks within the problem program and their relationship 
with the supervisor, are discussed. Selected Supervisor macros are 
also presented. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


Na Correct improper usage of EXCP, CCB, and WAIT macros used to con- 
trol a card reader, printer, console printer, or tape for any 
given operation. | 
2 Identify selected problem program option bits in a CCB and _ state 
the function of each. 
36 Correct improper usage of the Test Under Mask and Branch On 
Condition instructions when used to detect a carriage overflow on 
a printer and then cause a skip to ONE. 7 
4a. Use the PDUMP macro in an assembler source program to cause _ the 
printing of any given CCB during execution of the assembled 
program. 
ae State the function of the following Supervisor macros: — 
DUMP : | 
PDUMP 
 JDUMP 
EOJ 
CANCEL 
RELEASE 


Highlights 


@ A source program macro is a single assembler language instruction 
that will generate a number of additional assembler language in- 
structions through reference to a macro definition. 


e Macro definitions are stored in the source statement library. 

® IBM supplies three PIOCS macros to simplify coding of I/0 
requests. They are EXCP, WAIT, and CCB. 

® All I/O requests are issued by an SVC 0 (EXCP Macro). 

@ All I/70 requests require a Command Control Block (CCB). 

@ Use of the SVC 7 (WAIT Macro) ensures that all data is 


transferred from the I/O device before any processing of the data 
by the program is attempted. 
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Cha Lb 
lhe lm Mares — LVLemarn 


Wass Unotan tee. Ger Pi, WeITE Read 


\alttlaaatine DTF-LIOCS & Sam 

\ P CS \pem-- DIFOA 

‘bam- DIF TS 

SoH 6 
Troubleshooting Hints 
e On issuance of an I/O error message with an OP prefix, the CCB 
address is normally printed with the message. 

e Register 1 normally points to the last used CCB, bytes 9-11 of 


the CCB point to the first CCW, and bytes 2-3-4 of the CCW 
contain the I/O area address. 

e The contents of the Channel Status Word (CSW), except for the 
storage protect key, are put into the CCB on an I/O interrupt. 


tie welt A oY 
Widest 


IN: DOS/VS Supervisor and I/O Macros Smynt Poy mors 


UNDER: Macro Types and Their Usage At un besa Whe dilate. 
READ: Source Program Macros up, 106 

Macro Definitions 

Supervisor Macros 

Macro Processing it 

Notational Conventions ‘4 

Register Notation and Register Usage?! 


cf 


{ONDER : Physical Iocs macros iff 
READ: CCB Macro 7q4 
CCB Format , } 

EXCP Macro V) 

WAIT Macro ZN 


2 


VUsheachnom hogeeat DOCS 1) Dermsram Dea vsarn 


UNDER: Supervisor Macros %#§ 

READ: DUMP $2 
PDUMP 263 
IDUMP d 
EOJ oR 
CANCEL é 
RELEASE OMe . 


IN: DOS/VS Base SCM 1 


Physical Input Output Control System 
(PIOCS) Macros 


SELF-EVALUATION QUESTIONS 


1. The notation convention that indicates a parameter is required 
is: 
ae {[ | brackets 
be ceeee ellipsis 
Ce braces 


qd. —— rr t—<‘—si—s rn ee inte 
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2 What is the assumed value for the following macro parameter? 


ABC 
DEF 
GHI 
JKL 
ae ABC 
b. DEF 
Ce GHI 
d. JKL 
e. None of the above 


3. The CCB that will cause a record to be read from SYSRDR using a 
command-list-name of GO is ___ =. dé 
Lae RD CCB SYSRDR,GO 
b. CCB SYSRDR, RD, GO 
Ce GO CCB SYSRDR,RD 
d. RD CCB SYSRDR,RD 


e. None of the above 
4. When a WAIT macro is issued in a batch job environment, 
processing is suspended until the _. bit is turned on. 


? 


ae CHANNEL-END iad » sg 


b. DEVICE-END 
Lc. TRAFFIC BIT 
d. CCB 
e. TRANSMISSION BIT 5 of BYTE 2 


5. (True/False) A CCB cannot be in a logical stream of mnemonic 
? instructions because it contains constants (no mnemonic 
instructions). Tome 


6. The following is an example of a CCB that may appear in a storage 
print. What symbolic unit is this CCB for? 
J ae ae G 6 F | 
01068000 meee 00002800 00002820 


a.  SYS006 Bysees 
b. SYSREC 
Ce SYS016 
d. SYS106 
Le. None of the above 
7. Code the PDUMP macro to print the entire command control block 


CCB SYSIPT, RDCCW,X'0400',SENSE whose symbolic name is "READ". 


A ET EPS AED CEE AD OD AE A ES ES CERES EE EE OR ERE CTD EES ED SE EE END COS COTE TED I EE ED OR SEED A ED SRO CEE CEE EES CED SSS EE NSS CHEERY ONE 


pomp Ko , Loro+2¢ 
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8. 


10. 


(True/False) A problem program terminates normal processing by 
loading the Job Control program deck into storage from SYSRDR. 


The CCB that is correctly coded to print on SYSLST, using a CCW 
chain with the name of PRICCW, wait for device end, and accept 
unrecoverable I/O errors is: 


a. PRINT CCB SYSLST,PRTCCW,X'1004! * 
b. PRINT CCB SYSLST,PRTCCW,X'4O10' % ~ 
Gs PRINT CCB SYSLST,PRTCCW,X'1400' Vv 
d. PRINT CCB SYSLST,PRTCCW,X'4100' x 
e. PRINT CCB SYSLST,PRTCCW,X'4400! X 


Assume that a printer CCB named PRINT has been coded correctly to 
wait for device end. The TM instruction that could be used _ to 
determine if a channel 9 in the carriage tape of a 1403 printer 
has occurred is: 


16-23) 
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ae TM PRINT+3,X'02' 
b. TM PRINT+2,X'O4! 
() oc. TM PRINTHU,X"04" 
. de TM PRINT#+4,X'O1'8 
" @e TM PRINT+2,X'"40! 
11. In the CCB example for question 6, the address of the first CCW 
“} for the ccB is xX'____' and that of the last one executed is 
6 Mee (1) —» MIPIe 
12. Prior to scheduling an I/O request, the supervisor will reset 
which of the following bits in byte 2 of CCB? 
_ =e 0,1,2 
eu, De 3,49 45;6,;7 
ne oF 0 
ise «ye 0,2 r. 
__. @e None of the above « /Ht 
13. Match the CCB Fields shown below with their respective in- 
formation Source Fields. 
4 NOWE a. count (bytes 0 and 1) 1.  cswW 
ate. Je Transmission information (bytes 2. First oper- 
2 and 3) and in CCB 
A Ce CSW status bits (bytes 4 and 5) macro 
) ee Symbolic unit address (bytes 6 Be Second operand 
2 and 7) in CCB macro 
“" ___si‘é‘i CCW address (bytes 9-11) 4. Third operand 
Ln ae Eis CCW address in CSW (bytes 13- in CCB macro 
15) Dé Fourth operand 
ao qe Optional sense CCW (bytes in CCB macro 


peepee se 


14. 


15. 


16. 


Refer to the 


oe 
(True/False) Bytes 16 to 23 of a CCB (if present) will contain 
sense information at the completion of an I/O operation. 


2 
(True/False) When the ‘savearea' operand is specified in a 
RELEASE macro, the contents of Registers 0 and 1 will not be 
changed during execution of this macro. 


Which of the following macros can provide a dump of a problen 
program CCB? 


—--- a. DUMP 
--- b. IDUMP 
We-=- Cc, PDUMP 


Contents for the location of the self-evaluation question 


answers. 
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PIOCS MESSAGES 


EEE GLY CEES 


This topic briefly reviews low core wait state messages issued during 
IPL or program execution and discusses the use of 'OP' type messages 
to determine if an I/O failure is caused by hardware or software. 


The importance of system messages (printed or low core) cannot be 
over-emphasized. | 


A print 'OP' message is usually the first visual indicator to the 
system operator that a problem has occurred on an I/0 device. 


An I/O error may also be indicated when a system operator observes 
that the system is in the wait state. Prior to entering the wait 
state (due to a device error) the supervisor, if possible, will place 
a message in low core that describes the problem. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Use a PIOCS error message to locate any CCB for any I/O device. 
Le Locate the following items in a given PIOCS error message: 
Message number 
Action code 
Operator code 
Message text 
Logical unit that failed 
Device address that failed 
Command code of the last CCW executed 
CSW 
Sense bytes 
CCB address 
Seek address if DASD 
3. Locate and interpret a low core message when the system enters 
the wait state, and take the necessary corrective action as 
indicated by the message. 


Highlights 
@ Device error messages may be printed or stored in low core. 
® DOS/VS uses a fixed format message code. 
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CB wo lo'mG, 4. OTF Lies, | Whim PIOCS mates. LCP WAHT 2c . 


Ch, 6 Mi Aine. Aiobi OE ease _ Mah ‘5 ORD 9 TAPE Ay WSL 
I] ee Feed 5 009 ae ag > Roe Aroid Abe apse Or TPH, 
e | QTPPH vmtbe antd  CHKPT ASL arr DBD. 
idee [pate] onere THPRLE =o], A= 10 ir 
am see teats aeziage coae | (EATMREHRK Nou 
are bay “Appendix ‘i Sei i! [oot - “ee 


UNDER: Supervisor and IPL Messages [panoe: St | 28 2l 


REVIEW: Message Contents | S2yp 
— baa =) 
IN: ' DOS/SVS Serviceability Aids | 
and Debugging Procedures dic. 
92. section 2: Serviceability Aids 
UNDER: Section io Aids used for Gathering Infor- 
mation! U2dév. 
REVIEW: CF fteware STATE MESSAGES Wh unddarers One a: 4. 1 ayes LK Suseel, 
IN: DOS/VS BASE SCM 1 ae 3 uniréoe uD poe 
UNDER: PIOCS Messages 
REVIEW: PIOCS Messages 4-6 bo MO sae MS BY 
18 e4-h4 32 Ot 9b 
ttm 
, 4 CC vu 
SELF-EVALUATION QUESTIONS ; | 
mo. OP =D 


1. Match the ELEMENTS of the pea "'OP' message with their 
@ ca VALUES. 


op 11D R DATA CHECK SYSLINK=190 
CCSW=1D00002EC80E400008 CCB=002E50 SK=000000BE0002 
SNS=080000C80000 


ELEMENTS Uy VALUES 
~-- a. Message Number 1. 2EC8 
~~~ b. Message describing I/0 Le 190 
error condition 
ei OS Symbolic unit that failed 36 11 . 
~-- d. Address of hardware device ue 080000C80000 
—--- e. Sense data ar DATA CHECK 
~~-- f. CCB address 6. SYSLNK 
===: “Gs Disk address that failed Ts 1D 
~-~ h. CCW command code that failed 8. 2E50 
--- i. Address of CCW that failed 9. SYS190 
—-- J. Action code | 10. R 
11. QOO00000BE0002 
12. 2ECO 
Cx 13. D 
XY Ca [~ are oon eee Tt ale DYE mile 


) 3 es 
=o 7 


waa  fotaraFaca 
OT AAA 
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a satan ns ecm 


The system is in the wait state and a low core message of & 
X¥'*11C1000C' is displayed. The problem is: 
OPAIA PAR LH ON Oe 
Command reject on O0C 
Data check on 0C1 


Data check on SYS012 
Equipment check on O0OC 


ae 
b. 
et. Data check on OOC 
d. 
e. 


If a low core message of xX'08C1001F' was displayed when the 
system entered the wait state tee © PINT des Ot rs probably: 


} 


Ae A data check on the card hed a 

b. A data check on the console typewriter (01F) 
Ce A busout check in the card reader (00C) 

d. A busout check on the console typewriter (01F) 


e.% The console typewriter (O01F) probably out of forms “UNIT CAG a TEM, 


If the system message 'OP71I' is issued, the address of the CCB 
for the device that failed can be found: 


ae By displaying Register 0 on the CPU. 
b. In the I/O old PSW. 
Cs In the I/O new PSW. 


de By obtaining a storage print and looking in 

va Register 1. 

eC. None of the above. 

Physical IOCS messages consist of eight major elements. Which of _ 


these elements can be used to locate the CCW command code for an 
unsuccessful I/O operation? 


ae Message number 
b. Operator code 
Gy SYSXXX= 

d. CCSW= | 

Ce. SNS= 

Ex COB= 2 

g. SK= 


Tf the CPU enters a wait state after IPL time and there is no low 
core or operator messages, the problem could be a: 


a Unit check on SYSLOG. WO = O8C400 (04F 

b. Unit check on SYSRES. No = O&C403x¢ 

or Unit check on SYSRDR. NO 2 © &c4 DeeE 
Wis Missing interrupt. 


e. Program check in supervisor. Woe OD OO OF FF 


(True/False) An operator can respond to the following message 


with 'IGNORE'. PORNON Mune ber 4, JA prle mark, 


BG opis) c COMM REJCT SYSRES=190 


CCSW= 1F 1000204802000001 CCB= 002018 SK=000000000000 
SNS= 801000C80000) ~ Ane = 
=| R 


Set ALE mise T 6 


/ Ty \ TTy aa 
ow pe CHE, 
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Ch EL - 


tt To , yy ome! ea ~ nh dA 
8. The system is ina wait state and the low core message xX'*C8E2C9° 
is displayed. The problem is: 
i 
ha. Channel failure, codes in ECSW are invalid and error 
1 recording on SYSREC was successful. 

b. Channel failure, channel address invalid and error 
recording on SYSREC was partially successful. 

Ci Channel failure, channel address invalid and error re- 
cording on SYSREC was successfully recorded. 

d. Unrecoverable machine check that was recorded on SYSREC 
successfully. 

e. Unrecoverable machine check and error eseoraine on 


SYSREC was partially successful. 
_#t- None of the above. 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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LINKAGE EDITOR CONTROL STATEMENTS 


Getting a problem program into storage involves the use of: the 
output from a language translator, the linkage editor program and its 
associated control cards, the core image directory and library, and 
the supervisor fetch routines. : 


This topic will introduce the student to these items by using a simple 
two-phase program. Use of the linkage edit map as a diagnostic aid 
will also be covered in the two-phase environment. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Define and give an application for the following terms: 
Control section 
Source module 
Object module 
Program phase 
Program 
2 Use the following linkage editor control statements to construct. 
a multiphase program using object modules from SYSIPT. 
Phase 
Action 
Include 
Entry 
3. Recognize and correct any improper logic when using FETCH or LOAD 
macro. | 
4. Use the job control option of LINK or CATAL as required to make 
any linkage editor output either temporary or permanent in the 
core image library. 
oe Identify the parameters necessary to cause the Linkage Editor to 
produce Relocatable Phases. 


Highlights 

e PHASE card is used to name a phase and specify its load address. 

e The INCLUDE card, j# it has a blank operand field, signals job 

control to read an object module from SYSIPT and place it on 

SYSLNK. | 

® The INCLUDE card can be used to retrieve object modules from the 
relocatable library for inclusion into a phase. 

e The ACTION card is used to specify various linkage editor 
options, (clear, map, cancel, etc). 

® The ENTRY card can specify an entry point into a phase and 
signals the end of input on SYSLNK. 

@ In a multiphase program, a FETCH or LOAD macro must be issued to 


load each succeeding phase of a program after the first phase is 
placed in core. 
® Job control loads the first phase of a program. 


Troubleshooting Hints 


@ Investigate all error messages in the operator's guide. 

® Use the linkage editor map to determine the load address, 
relocation factor, entry point and CSECTS in a progran. 

® The failing object deck card will be printed alongside the error 
message on SYSLST. 

@ Linkage editor error messages print on SYSLST. If NOMAP is 


operational, no error messages will print. 


Activity 


cs, a ie 


system Control Statements 


IW: 
READ: 


bvie LINKAGE EDITOR 
y through 1-449 
ACTION STATEMENT 


SELF-EVALUATION QUESTIONS 


1. An unnamed START statement in a source module will result in a 
6,7 __tG. ss code generated in the ESD output. 


fc? 20 A named CSECT statement in a source module will result in a 
© : ______ code in the ESD output. | 


TN EG EE ERS AEE ELT LIED STARS AEN CURRY I AP ETE SIG A RT: SLI IS 


3 A control section (CSECT) is defined as 


OD CY ED DEED OD EE PIED ERE AID LES CTT EARL T TSS ES NS ELL SLID EY LS OLLI 


QW. Cross-referencing between control sections is performed by a 
program known as * 


ERPS EP UEEED CED GED EE <P ESS ATE SE ce ID RS SLID 


Ds An ER entry appearing in the ESD is the result of having proc 
EXTAV | cessed a statement. : 


ED ALLS ALA ABAD SAEED) SEED eae eD ae cana ea ED ee 


6. List the three methods of defining an entry point into a phase 
during linkage editing. 


SS CEES OES NY AD SLY A OL ATT TD A AS TS Te TN aS A A A oT SS SY AS TS aT aT ID SY NT ED AS A AS OP AAR 


ERATED GIEEED ETD SSPE GAP HTD ETD a OD GILT AED I 


SETTLES AEE ED OE ENE BARS GRE AT PERG AIEEE ALE IL TE PER PLES: ESET CRESTLINE AIT SLL EET LAID LEED TNE LED GOREN 


Vs How can a problem program overridd the entry point established 
during linkage editing when fetching another phase? 


AED AU GED ARES TAD CE ARDY CORE IND SED CNAME VED AGREES CLEP MNS PLP ES IP TG ES LSE IIT SS ATPL LD EID RP PTA TED LEY ALTOS ST ILS ORS CTE TEETI TST LTTE LIER RT CERES R EI TLD 
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8. How can you indicate that the linkage edit output is to be S 
permanently cataloged into the core image library? 
Atti =KeL | 
Ot Ten= 


LLP LAS ES ATS TS IE ATT ES TT LT AS OS I: A AT NS ES SNA SRE RED enOSP SNDD EENINRD SAREE COENEN SORIA RODEN ecm tame NeNnN 


// OPTION LINK 
PHASE PAYROLL,S 
INCLUDE, (CSECT1,CSECT3) 
(Object Module 'Mainline') 


INCLUDE PTIME 
J// EXEC LNKEDT 


// EXEC 

9. The preceding cards will cause a program called CaS Lo 
to be entered into core at Doe i oes Sti 6 ae oe Nes oe 
This phase will consist of _ ___and___ Of the 
module, and 4 of the _j 4: module. 

10. A phase will not be made relocatable if the PHASE card spec- 
ifies origins of... OP _.or if the 
ACTION card has the _  Copttion coded. 


Refer to the Contents for the location of the self-evaluation 
question answers. 


- fapec Nite | = i ais “peated ae “ape 
0. Laks afinks @ vend fp prance pana © 


© Wie. J Ga BEY ie raed & ENE ONT Nerdy 
75 woedlule wrediale THT eds il 1.6 preinae Lees. 
~ RD ins Ave Mamliiied 2 rated. 
Pen Cyber wt f> R Atferercer when all beeper precaution Can be. wide. 
SA SD Attr~ a! oe Nam NaAGIN ONGTH 


wk Ls ; 

0 

Ie mle V- tyke, Geral We 

Cw Mh: Cm Arntmblet an 

wits a cS te mr) (peal m Nlrcaten~ - the AQUNS 

ie oe | be tl Wyss a deat aaaed eye 
hn + Uy» ee a ewe 
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LINKAGE EDITOR OPERATION 


Multiple phases exist in many IBM supplied programs, and the ability 
of the PSR to trace the flow of control through these phases is a 
necessity in program troubleshooting. 


OBJECTIVE 

Upon completion of this topic, the student, using the available 

documentation, should be able to: 

1. Determine the phase currently in core, the calling phase and the 
next phase to be fetched when given a multiphase program listing 
and linkage editor map. 

2. Define trouble to a specific phase and submit an accurate APAR to 
report this failure. 

3. Use a linkage editor map to locate program phases in core when 
their assembled addresses on microfiche do not agree with the 
core locations. 

4. Given a linkage editor map, draw a core layout showing the 
location of all phases in the progran. | 

5. Given a card deck with control card errors, linkedit and execute 
the program by eliminating all errors. 

6. Identify the directories on SYSRES which are affected during a 


linkage editor job stream when the following control statements 


are processed. | . 
'// OPTION tink Ale att phages emp Cab 2 CEL 
// OPTION CATAL 
// EXEC 
// BXEC (OPERAND) CIL 


Highlights 


Programs are composed of one or more phases and a phase may be 
composed of one or more control sections. 

When using assembler language, a control section is defined by 
START or CSECT statement. 

The output of all language translators, Assembler, COBOL, etc, 


‘contain the same format object module consisting of ESD, TXT, 


RLD, and END cards. 

The linkage editor always goes to SYSLNK for its input. 

The job control OPTION card parameter for LINK causes all phases 
in this job step to be temporarily cataloged in the core image 
library, and they cannot be brought into storage after a /& or // 
Job card is read. 
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Troubleshooting Hints 


@ Sequence of card types in an object module are ESD, TXT, RLD, 
END. 

e Each object card has a type identifier in card columns 2, 3, and 
QW. | 

e Each card in an object module is sequence numbered in card 
columns 77-80. 

6 Use a REP card to correct bad data in an object deck. 

e The REP card must occur after the data to be replaced. Usually 
placed just before END card. 

Activity 

IN: DOS/VS System Control Statements 

UNDER: Linkage Editor 

READ: Linkage Editor Input Considerations 
7 through 

Example of Linkage Editor Input and Output 
STUDY: Figure ‘Storage Map* (Part 1 and Part 2) and 
associated text. | 

IN: DOS/VS Librarian PLM | 

UNDER: System Residence Organization and Private Libraries 

READ: System Directory 


through 
Core Image Directory 


SELF-EVALUATION QUESTIONS 


1. 


Place the following steps of a job in the proper sequence. 


== A Code and assemble PHASE1; use the fetch macro. 
--- WX. // EXEC PHASE1 is read by job control. 
~—~ 0 Code and assemble PHASE2; use the EOJ macro. 
~-- d. PHASE1 is loaded and executed through to the 
FETCH PHASE2 macro. 
--- @& Construct control cards and perform a linkage edit 


run. 7 
“~~~ £. Supervisor loader loads PHASE2 into core fron cI | 
library. | 
ae os Supervisor loader searches the core image direct- 


ory for PHASE2. 
=o= ‘le PHASE2 executes through to the EOJ macro. | 
~-~ 1. Supervisor loader branches to the entry point in | 
PHASE2. is 
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2. From the following linkage edit map, list: 


ae the names of all phases. | 

b. the storage locations they will be loaded into. 
Ce the entry point address of each phase. | 

d. the disk storage address where each phase is 


stored. 
PHASE XFR-AD LOCORE HICORE DSK-AD ESD TYPE LABEL LOADED REL-FR 
COMMON | COM 020000 000500 


PHASEO1 020500 020500 020830 30 7 2 CSECT G01 020500 008500 
PHASEO2 020880 020880 030870 30 8 1 CSECT G02 020880 020880 


PHASE NAME = CORE LOCATION ENTRY POINT DISK ADDRESS 


> STAD CONE AD A IS LS SD LS a > 


3. What symbolic units must be assigned to perform an assemble 
and execute operation? 


eu qh» EE em. AP A OD A TN LL I ED eee AGP AD pea ae eee eee 


4. If SYSLOG prints the message 2199I, it means that 


TT LD 


Refer to the Contents for the location of the self-evaluation 
question answers. 
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VIRTUAL STORAGE CONCEPTS 


This topic introduces the student to the basic DOS/VS system 
functions and concepts that are required to successfully IPL, 
load the Supervisor and Job Control, and then transfer control 
to either a real or virtual problem program. Presentation and 
discussion is limited to a general and conceptual development 
of the need for the various functions and services provided 

by the supervisor, page manager, operator commands, and macros 
in a virtual environment. | 


Development of the need for these functions and services, and 
familiarization with their associated terminologies will pro- 
vide the student with a basic overview of system operation that 
will be of considerable benefit during the remaining topics of 
this course. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Describe, in logical sequence, and using conceptual terms, 
the basic DOS/VS system functions and services required to 
IPL, load the Supervisor and Job Control, and execute a 
real or virtual mode program. 

2 Identify the status and/or location of any DOS/VS virtual 
or real partition page when given its corresponding page 
table entry. 


Activity 

IN: | DOS/VS SCM 1 

UNDER: VIRTUAL STORAGE CONCEPTS | 

STUDY: The figures as indicated while reading 
the following text. 

READ: The following: 


Refer to the Figure Titled: DOS/VS SYSTEM FLOW OBJECTIVES 


e This figure identifies the basic DOS/VS system functions 


flowchart sequence that are to he discussed in conjunction with 


the remaining referenced figures of this topic. Study the 


before proceeding until you have a basic understanding of the 


functions that are to be discussed. Refer to this figure at 
time that you lose the overview of what is being presented. 


Refer to the Figure Titled: DOS/VS IPL FUNCTIONS 


e IPL is loaded Qa) and executes in real storage as ae single 


partition system in the supervisor state with DAT off. 


au 


© IPL moves to high storage (2) and the Supervisor is loaded into 
low real storage by IPL - It remains there permanently (it 
is never paged out). e supervisor initially contains two 


temporary routines (INITDAT and INITPT) in the CCW translation 
copy buffer area that are executed at IPL time to initialize DAT 
and the page management tables. After IPL these routines are 
overwritten and never used again. | : 


® After the supervisor has been loaded during the execution of IPL, 
the INITDAT routine (in the supervisor) is entered ° This 
routine initializes ALL system page tables and page frame 


tables (not shown). It then activates DAT in the supervisor 
(this is the one and only time that this routine is ever 
executed.) 


- Page table entries for all of the real address space 
are loaded with the 13 high order bits of the real 
addresses for the page frames associated with each page 
table entry. | 


- Page table entries for virtual address space are 
invalidated (set to X'8001"). These entries are 
invalidated because an address higher than that of 
available real storage should never be referenced 
during execution of IPL. 


therefore addresses are being translated during any _ 


@ Remember -- DAT is ON in the Supervisor during IPL, and 


execution of supervisor code. If a virtual address — 
Space page table entry should erroneously be referenced > 
during this time, an addressing exception program check 
will occur because of the high order bit being ON in 
the PT entry. | | 


® After INITDAT has been executed IPL waits for the operator to 
enter the IPL Control Commands via the communications device 
(either SYSLOG or SYSRDR) 6) - The commands that the operator 
enters are: | 


- ADD (optional) 
- DEL (optional) 


- SET (required) 
- CAT (optional) 
- DPD (required) 


The DPD command causes the paging data set (SYSVIS) to be 
formatted at this time. 


® The EOJ transient (End-of-Job) is loaded (7) into the LTA 
(Logical Transient Area) in the supervisor and executed upon 
normal termination of all programs (including IPL). EOJ then 


issues an SVC 59 which prepares the virtual partition to receive 
Job Control. Remember -- Job Control ALWAYS executes in virtual 
mode. 


@ Refer to the Figure Titled: FUNCTION OF THE INITPT ROUTINE 
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6 During the execution of FOJ that terminates IPL, the INITPT 
routine (in the supervisor) is entered prior to the 


execution of the normal SVC 59 routine. (This 1s the only time 
that this routine is executed.) This routine initializes ALL 
virtual and real page table entries to reflect the systen 
allocations as specified at SYSGEN. 11 page frame table entries 
(except those for frames in which the supervisor resides) are 
also initialized by this routine to the ‘unused’ state (not 
shown). 


® After the INITPT routine has been executed at the termination of 
IPL, control returns to the EOJ transient which then issues an 
SVC 59 to prepare BGV for Job Control (not shown). The specific 
functions of the SVC 59 will be discussed later in this topic. 


® The BOUNDRY BOX (located in the supervisor) supplies the INITDAT 
and INITPT routines with the necessary system specifications 
which they require for initialization of the page management 
tables. The boundry box entries are filled in (loaded) during 
SYSGEN and are available in the supervisor when it is loaded into 
storage during IPL. 


@ An SVA (Shared Virtual Area) 7) is generated in all DOS/VS 
systems at the Release 29 (or later) level. 


® SVA size can be specified via the VSTAB macro at SYSGEN time. If 
none is specified, a minimum of 64K SVA is always generated. 


® Even though generated, the SVA in a single partition batch systen 
is not available to the user (customer). 


Refer to the Figure Titled: LOADING OF JOB CONTROL AFTER IPL 


@ The final function performed by the EOJ transient is to issue an 
SVC 4 (Load phase) which transfers control to the FETCH routine 
in the supervisor dy - Prior to issuing this SVC 4, EOJ places 
the phasename of Job Control and the BGV lcad address (virtual 
address at which Job Control will be loaded) in registers 1 and 
0 respectively. The load address for BGV is obtained from _ the 
boundry box. 


@ The FETCH routine now locates Job Control in the Core Image 
Library and builds an I/0 CCW string to bring in Job Control 
- Since Job Control is always loaded into a virtual partition, 
in this case BGV, the I/O area addresses in the FETCH CCWs are 
virtual address area addresses. These virtual addresses cause 
the FETCH CCW Translation routine to request and TFIX page 
frame (s) via the page manager (PMGR) G) ° The PMGR 
interrogates the page table entries that encompass the BGV 
addresses contained in the CCWs and finds that they are ‘invalid’ 
(x'0015') @ . As a result, the PMGR TFIXes and clears to zero 
the necessary page frames in real storage 6) P The real 
addresses of these frames are then placed in the FETCH routine 
ccWs. The 13 high order bits of the real address for each 
selected frame are also placed in the PT entry that represents 
the 2K of virtual code that will be loaded in that frame ©) : 
Control returns to the FETCH routine @) which then issues an 
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SVCO (EXCP) to execute the I/0 CCWs that load Job Control @ ‘ 


Job Control is now in real storage, but in effect, at a virtual 
address. | | 


The TFIXed page frames which now contain Job Control are TFREEd 
after the I/0 operation which loads them is complete @ . 
These frames could now be paged out to SYSVIS if the page manager 
should require more page frames than are available. Remember -- 
page frames are only required to be MTFIXed during an I/0 
operation so as to avoid the possibility of their being paged out 
before all data has been read into then. 


Depending on the size of the program being loaded, the FETCH 
routine may not be able to build all the CCWs required to load 
the entire program at one time. If this is the case, a program 
FETCH (or LOAD) may require several I/O operations to load an 
entire program and steps 6) through (9) would be repeated 
until all core image library blocks for the Eeegeee had been read 
into real storage. 


After FETCH has completely loaded Job Control into a partition 
(BGV in this case) control is given to the task selection routine 
(dispatcher) in the supervisor. Task selection will then 
activate the partition with the highest priority that is ready to 
run (in this case BGV). 


Refer to the Figure Titled: LOADING A VIRTUAL PROBLEM PROGRAM 


When Job Control is in storage, it processes any JCL statements 
or commands that may be issued until an EXEC statement is read. 
At that point the virtual partition in which Job Control is 


executing (BGV for example) must be prepared to accept the 


program specified in the EXEC statement. 


Processing the EXEC (by Job Control) ,loads routine into | 


registers| in the partition Save Area (cone snee in the first 2K 
of the partition) with parameters that will be needed by the 
FETCH routine in the supervisor to load the requested program 

- This save area routine will later issue an SVC ‘4 which will 
transfer control to the FETCH routine. 


After the save area routine has been built, Job Control issues an 


sve 58 which will initialize the partition to receive the 


requested program Q) - This supervisor resident SVC routine 
performs the following basic functions when the program to _ be 
loaded will execute virtual: 


- All of the virtual partition page table entries are 
invalidated (EXCEPT the first one) to X'0015* (x'0015° 
in this case because it is BGV) 2 - The first page 
table entry is not invalidated because the partition 
Save area is in the first 2K and the information saved 
therein is still needed. 


= All page frame table entries for frames that contain 
BGV pages of Job Control (EXCEPT for the frame that 
contains the first 2K) are initialized to the ‘unused' 
state (not shown on figure). 


4] 


The load routine in the BGV save area that was built by Job 
Control is now executed (@) . This routine issues an SVC4 (LOAD 
phase) which causes entry into the FETCH routine in the 
supervisor. The parameters needed by FETCH to load the requested 
program are also passed to the supervisor at this time. 


The problem program is now loaded to the virtual partition by 
FETCH in the same manner as was previously described for the 
loading of Job Control © . | 


If the program being loaded exhausts the available page frames of 
real storage, pages already in real storage frames are paged out 
to SYSVIS in order to make frames available for the balance of 
the program being loaded 7) . Virtual partition page table 
entries that represent virtual address space pages that are on 
SYSVIS are set to X"'O0X4* (X'0014" for BGV). This indicates that 
the page is not in real (INVALID bit ON) and a copy of the page 
is on SYSVIS (USED/ UNUSED bit OFF). 


After the problem program has been completely loaded, task 
selection. again activates the partition with the highest priority 
that is ready to run (BGV in this example). 


Refer to the Figure Titled: CONCEPTS OF CCW TRANSLATION 


The System/370 Dynamic Address Translation facility (DAT) does 
not function for channel programs. Therefore, prior to the 
execution of a virtual program I/0 request, any referenced 
address in virtual CCBs and CCWs must be translated into their 


Gorresponding “Teal addresses” ‘by the DOS/VS supervisor. 


The supervisor must do the following before initiating an I/0 
operation for a virtual mode program. 


_ Co the CCB and the entire channel program into copy 
blocks in the supervisor. : 


-  _Translate the addresses used by the CCB and the channel 


“program into real storage addresses and place these 
addresses in the copied CCB and channel progran. 


- Build IDALS (Indirect Data Address Lists) in the 
supervisor for all I/0 areas which cross one or more 
page boundaries. | 


- Fix all pages containing 1/0 areas in real storage for 
“the duration of the I/0 operation. 


The channel scheduler routine in the supervisor is entered as a 
result of an EXxCP (1) . The channel scheduler may require the 
services of the page manager to get. the virtual CCB and CCWs into 
Leal storage if they are not already in real (dotted “Lines in 
figure) . 
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NOTE: The page frame in which the virtual EXCP instruction 
resides in real storage is not shown in the figure. 


e It is important for you to realize at this point that the virtual 
CCB and CCWs, even though they are now in real storage, still. 
contain virtual address space addresses which must be translated 
to their corresponding real addresses before the I/0 program 
(EXCP) can be executed. This function is performed by the CCW 
Translation routine in the supervisor because the DAT hardware 
feature does not function for channel programs. | 


e The CCW Translation routine copies the virtual CCB and CCWs into 
copy blocks located in the supervisor (©) It is in these copy 
blocks that the ‘'real' channel program is built and executed. 
The virtual I/O area addresses in the CCWs are examined and if 
the I/O areas specified by the virtual addresses are already in 
real storage frames, the frames are TFIXed and the I/O area _ real 
addresses are inserted into the CCWs in the copy blocks. If upon 
examination of these virtual addresses, the CCW Translation 
routine finds that the I/O areas are not in real storage, a 
request is issued to the page manager to obtain and TFIX the 
necessary frames for the I/O areas. They are then paged in fron 
SYSVIS and their real addresses are inserted into the CCWs in the 
copy blocks G) ‘ The channel program is then scheduled and 
executed. 


@ After the I/O is completed, all the TFIXed frames are TFREEd, and 
the original virtual CCB and CCWs in real storage. (in the page 


pn er : conaevennesrvatin spre te ant gehts ; 
pool aréa) are updated to reflect the contents of the copied CCB 
a nN a CC Ws i eT oe ete a an NS NE ap AEF St BEN 2 RCO nO gy a Ray 0 NG yi 
——o~neeeeet - 


Refer to the Figure Titled: PFIX/PFREE CONSIDERATIONS (PART 1) 


® A virtual program may require that certain of its pages be 
maintained in real storage for an extended period of time (ie, TP 
programs). |In order to prevent the possibility of these pages 


being paged out by the page manager, a PFIX (perWanent fix) 


be issued by the program that will remove the page fra 


“selection” pools when “a “page frame has 
‘S@Tection pool, it is no longer a candidate for paging activity. 
A page frame is removed from the selection pool by turning ON a 
specific bit in its associated page frame table entry. | 


@ PAGES CAN ONLY BE PFIX'ED IN THEIR CORRESPONDING ALLOCATED REAL 
PARTITION. 
e Virtual program (F1V) issues PFIX for two-2K pages (addresses 


need only fall within 2K area -- they do not have to be on 
starting or ending page boundaries) @ . 
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The page manager PFIXes specified frames by removing them from 
the selection pool (turns a bit ON in corresponding page frame 
table entry) @ . Page(s) may also be brought into real 
storage from SYSVIS by PGMR if not already in real (dotted lines 
in figure). If already in real, page(s) must be in corresponding 
real partition (F1R) or an exchange of frames will occur (this 
situation covered in next Figure). 


NOTE: If pages to be PFIXed were not in real storage and 
there were no available frames in FIR, a unique 
bit in ALL the page frame table entries for F1R 
would be set to indicate that frames are needed 
for a PFIX. As soon as frames became available in 
FIR, they would then be used for the PFIX. 


PFREE returns previously PFIxed page frames to_ selection pool 
(resets the SP bit in page frame table entry) : 


Refer to the Figure Titled: PFIX/PFREE CONSIDERATIONS (PART 2) 


When virtual pages that are to be PFIXed (X and Y in F1V) are 
already in real storage, but not in frames that belong to the 
real partition corresponding to the virtual partition that issues 
the PFIX (pages X and Y in real are in main pool frames -- not in 
FIR frames), a specific bit in the page frame table entries for 
the frames in which they do reside is set by the page manager 
2) . This bit indicates that pages contained in these frames 
(indicated by right and left dotted lines from @) ) are to be 
moved to different frames and should not be paged out. These 
pages are then moved to frames in the corresponding real 
partition (F1R) in the real partition, IF there are available 
‘unused! frames on the real partition, or if pages in the real 
partition can be paged out to make frames available. 


A situation may exist, however, in which all the frames in the 
corresponding real partition are either TFIXed or PFIXed as shown 
for F1R in the figure. In this case, another specific bit is set 
in all the frames of the desired real partition (F1R) to indicate 
that frames are needed for a PFIX (indicated by center dotted 
line from @) )-AS soon as the required number of frames become 
available in the desired real fartition (TFIXed or PFIXed frames 
are TFREEG or PFREEd), the desired pages in the frames outside 
the real partition (X and Y in the MMP) are exchanged with the 
contents of the now available frames in the real partition (pages 
A and B for examples as shown in the figure) 3) - These 
frames in the real partition are then PFIXed. 
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Refer to the Figure Titled: GETVIS/FREEVIS CONSIDERATIONS 


Unused address space in a virtual partition (addresses above 
those that are required for a program that is loaded into the 
partition) can be utilized by other storage management routines 
(ie, VSAM) that the executing program may require. This unused 
area is called the GETVIS area and that portion of the partition 
in which the executing program resides is called the SIZE 
area. 


The SIZE operand of an EXEC statement specifies how much of the 
artition will be required for the program that will be loaded — 
| - The remaining address space, minus 2K, becomes the GETVIS 
area. 


The SIZE operand in an EXEC statement can be specified as SIZE=nk 
('n' must be an even multiple of 2), or as SIZE=AUTO. If AUTO is 
specified, the GETVIS routines in the supervisor @) will 
automatically make the SIZE area equal to the loaded programs 
size. If SIZE=AUTO, nk is specified, an amount of the partitions 
virtual address space equal to nK will be added to the AUTO 
amount. 


When an EXEC statement is executed with SIZE specified, a 1K VSAM 
ANCHOR TABLE is generated immediately above the SIZE area. This 
table is used to monitor VSAM phases in the GETVIS area if VSAM 
is used. A 1K GETVIS MANAGEMENT TABLE is also built immediately 
above the VSAM anchor table. This table contains constants and 
a bitstring that monitors the use of the GETVIS area. Each bit 
in the bitstring indicates whether a specific 128 byte increment 
of the GETVIS area @ is being used or is unused. 


NOTE: The Shared Virtual Area (SVA) of a DOS/VS System 
can also have a GETVIS area. It is basically the 
same aS a partition GETVIS area with the exception 
that the SVA GETVIS Management Table is 3K in 
length rather than 1K and each bit in the SVA 
GETVIS bitstring represents 512 bytes of an SVA 
GETVIS area. More on this later in the course. 


If the SIZE operand is specified in an EXEC REAL statement, the 
real storage above the SIZE area in the real partition remains in 
the selection pool (it is available for paging activity, whereas 
the SIZE area is not). 


A problem program in a virtual partition that has a GETVIS area 
can request the use of and obtain GETVIS address space by issuing 
a GETVIS macro instruction (@) . Specifics on the GETVIS macro 


will be discussed later in the course. : 


A FREEVIS macro instruction releases address space in a GETVIS 
area that was previously obtained by a GETVIS macro instruction. 


Refer to the Figure Titled: TERMINATION OF A VIRTUAL PARTITION 


Upon normal termination of a virtual program, the partition page 


table entries must be invalidated (set to X‘'00X5') and page frame 
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table entries for frames that contain the virtual program pages 
must be initialized (set to tunused'). If any frames are still 
PFIXed because the program did not issue a PFREE, they are 
released and returned to the selection pool. 


e The FOJ transient is called at the normal completion of the 
progran @ just as was seen at the completion of IPL. £0J 
issues an SVC59 (@) #£which causes entry into the routine in the 


Supervisor that will prepare the page management tables for the 
loading of Job Control @) . All page table entries for the 
virtual partition are set to X'00X5* (X*'0015*' for BGV) and page 
frame table entries are set to ‘unused! (dotted lines). 


e Control returns to the FOJ transient from the SVC59 routine which 
then issues an SVC 4 G) . This causes the FETCH routine to 

ad Job Control into the virtual partition (BGV in this case) 

65 - Refer to text associated with the loading of Job Control. 


Refer to the Figure Titled: LOADING A PROBLEM PROGRAM TO EXECUTE REAL 


e j A program that is to execute real mode has the REAL operand 
specified in the JCL EXEC statement that calls the program 
(ie, // EXEC PROG,REAL). 


e Job Control builds a load routine in its save area in the same 
manner as it does for the loading of a virtual program . 
An SVC 58 is then issued by JCL just as it was for a virtual 
progran 2) .« The load routine in the partition save area is © 
now, however, moved to a save area in the Supervisor 
This occurs because the program to be loaded will execute real 
and All of the virtual partition page table entries will be 
invalidated to x'8011" (recall that the first page table entry in 
a virtual partition was not altered by the SVC 58 when a program 
was being loaded to virtual.) 


e PT entries for the virtual partition are examined one at a_ time 
‘by the SVC 58 routine and set to invalid @) . If an entry, on 
examination, is found to contain a valid real address, the 
corresponding page frame table entry (not shown) is initialized 
(reset) and the frame is returned to the selection pool (dotted 
lines from @) ). | 


e Because the program is being loaded to execute real, the page 
frame table entries for the frames in the allocated real 
partition (corresponding to the virtual partition in which Job 
Control is executing) must be removed from the selection pool and 
prepared to receive the specified program. In addition, the page 
table entries for the real address space in the real partition 
must be loaded the real addresses of their associated page 
frames. These functions are performed by the GETREAL routine 
(SvC55) in the supervisor during the execution of the SVC58 
routine (NOTE: The Ssvc55 routine is not entered when a program 
is being loaded to execute virtual). 


e The GETREAL routine examines the page frame table entries for the | 
| real partition being activated and sets a bit in each entry to | © 
indicate the frames are to be removed from the selection pool | 
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a 


11. 


12. 


13. 


14, 


15. 


(True/False) At completion of a virtual program (EOJ), any pages 
of the program that are on SYSVIS (have been paged out) are 
erased by writing binary zeros (0) in the relative disk records. 


(True/False) All page frames in an active real partition are 
PFIX'd. | 


(True/False) A real partition cannot execute a V=R program until 
all TFIX'ed page frames in the partition have been TFREE'‘ed. 


When a real partition terminates, the routine that will bring Job 
Control into the corresponding virtual partition is contained in 
which of the following: 


Ae _._._..... Real partition savearea 

b. ___._..... Virtual partition savearea 
Cc. | LTA 

d. _ Supervisor 

e. __ _... PMGR 


Match the following SVC codes to their associated DOS/VS 
functions: 


SVC_CODE FUNCTION 
_.. ae SVC 55 1. Initialize a virtual partition 
_.. be SVC 54 : for a problem program 
__. Ce SVC 58 2. Initialize a virtual partition 
d. svc 59 for Job Control 


3. Obtain real storage frames for 
a V=R function 
4. FREE REAL 


Refer to the Contents for the location of the self-evaluation question 
answers. | 
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Previous topics have introduced the need for various basic DOS/VS 
system functions in broad and conceptual terms. This topic discusses 
specific virtual storage management macros that can be utilized by a 
programmer when coding a program that is to be executed in virtual 
mode. Internal virtual storage management functions such as TFIX, 
GETREAL, etc are not addressed in this topic, but will be _ covered 
later in the course. . 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
| documentation, should be able to: 


41. Detect and correct errors in the use of the following virtual 
storage macros: 
GETVIS 

FREEVIS 

PFIX 

PFREE 

RU NMODE | 

SETPFA 

VIRTAD 

REALAD 

EXCP, REAL 


Highlights 


e GETVIS and FREEVIS macros can be used to manage Partition and 
System GETVIS areas. | 

e RUNMODE can be used by the program to determine if the program is 
executing virtual or real. 

e PFIX provides the programmer with the ability to permanently fix 
pages of his program in storage. 

e SETPFA provides the programmer the ability to select the sequence 


in which page faults are handled by the systen. 

VIRTAD provides the virtual address for a specified real address. 
REALAD provides the real address for a specified virtual address. 
CCW translation is not performed for EXCP,REAL. © 
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Troubleshooting Hints 


@ If a problem is stspected in a macro, use the DOS/VS Supervisor 
and I/O Macros SRL to ensure the macro operands are specified 
correctly. 

® Inspect the code generated for a macro for obvious errors. 

® Ensure that if return codes are returned after a macro is 


executed, the programmer checks these codes correctly. 
® Check the operator commands (ALLOC, SIZE, etc) submitted with a 
program by using the MAP command. 


Activity 
IN: DOS/VS Stipervisor and I/0 Macros 
UNDER: Virtual Storage (Part 7) 
READ: Descriptions of the macros specified in 
OBJECTIVE 1 with the exception of the EXCP,REAL macro 
UNDER: Physical IocS (Part 6) 
READ: EXCP macro 


SELF-EVALUATION QUESTIONS 


_ Vs The following PFIX is issued by a virtual program executing 
in a 256K real storage CPU: 


PFIX LIST | _ 
LIST DC X*00050000000008FF' 
DC -— ¥*0103000000000C00FF* 


The number of page frames that will be PFIXed in real storage is 


, e 
—_ CED CEES TTL RIO ETE LEP LTD TEES SAD 


2. A page frame with its PFTX byte equal to X'FF'  — (is/is 
not) available for demand paging. 


3. (True/False) When the RUNMODE macro is issued to a program 
executing in F3R, X'00000004' will be returned in Register 15. 


4. The BGV partition (128K) is executing the following 24K program 
in a 1 MEG DOS/VS system (512K Real + 512K Virtual): 


J// EXEC PROG,SIZE=32K 


The BGV GETVIS area for this program begins at address 


LE AEE TAS SES 


THE GETVIS VISTAB (BITSTRING) begins at address X'__ t, 
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(True/False) Specification of *POOL' in a GETVIS macro causes 
the search for unused GETVIS address space to begin at the 
address contained in R15. 7 


(True/False) The address specified in the "ADDRESS=" operand of 
a FREEVIS macro must be a multiple of 128. 


(True/False) When a DOS/VS system includes a Page Handling 
Overlap (PHO=YES), page faults occurring in a problem program 
task are resolved by the problem program PFA routine and not’ the 
system page manager, after a SETPFA macro has been issued for 
that task. 


(True/False) A PFIX must be issued for the Virtual address space 
in which an EXCP,REAL expansion resides prior to execution of the 
EXCP, REAL. 


(True/False) Register 0 will contain a Virtual address after 
execution of a VIRTAD macro that specifies the real address of a 
byte that is within a page frame which is in the selection pool. 


Refer to the Contents for the location of the self-evaluation question 
answers. | 


DOS/VS_SERVICEABILITY AIDS 


In addition to the numerous DOS/VS serviceability aids that can he 
executed via operator commands and job control statements (ie, ALTER, 
DSPLY, DUMP, // OPTION DUMP, etc), there are several serviceability 
PROGRAMS that are available to the PSR for problem determination of a 
DOS/VS System/370. This topic introduces and discusses the Problem 
Determination Aid and System Debugging aid programs (PDAID and SDAID), 
as well as the SYSVIS Dump progran. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Initialize and terminate, via SYSLOG or SYSIPT, any of the 
following DOS/VS serviceability aids using the correct 
initialization parameters to trace any specified event(s) and 
dump any specified type of output. 

@ PDAIDS (Problem Determination Aids) 
-IO Trace 
-IF Trace 
-GSVC Trace 
-QTAM Trace 
-Transient Dump 

® SDAIDS (System Debugging Aids) 
-Elementary Events 
-~Dedicated Events 
-Stop On Event 
-Dump On Event (NDD) 

@ PDSDM (Page Data Set Dump) 
~Output to Tape or Disk 
-Output to SYSLST 
~Tape or Disk Output to SYSLST 

2- Correctly interpret and state the meaning of any selected entry 
in a given type of output obtained from any of the following 
DOS/VS serviceability aids. 


® PDAIDS 
® SDAIDS 
@ PDSDM 


@ Four event tracing routines and one dump tracing routine are 
provided by PDAIDS;: 
-I/0 Trace 
-FETCH/LOAD Trace 
~GSVC Trace 
-QTAM Trace 
-~Transient Dump 
@ PDAIDS run on any System/370 that supports DOS/SVS 
@ Real Storage area required for execution 
-~called PD area 
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-PD area located in Supervisor 
“must be reserved at SYSGEN time via PD parameter of FOPT macro @ 


® Initialization is via real or virtual partition (// EXEC PDAID). 

® Control given to PDAID routines via ‘thooks' in Supervisor (Upon 
return from PDAID--processing continues as if event had not 
occurred). 7 

® PDAIDS run with DAT "Ont and Disabled for I/O and EXT Interrupts. 

® Only real storage can be dumped with PDAIDS (Transient Dump). 

e PDAID events are mutually exclusive. 

e PDAIDS may run concurrently with SDAIDS (Except when PDAIDS uses 


the alternate area for output). 

® Program execution time is slightly increased by PDAIDS. 

@ Output from PDAIDS is directed to a non-dedicated line printer. 
(The same printer may be used as an output device for other 
programs). 

@ PDAID initializing and terminating routines (Programs) must be 
cataloged in the Core Image Library. 


Troubleshooting Hints (PDAIDS) 


1. The following hints identify situations in which the various 
PDAID functions can assist you when determining a DOS/VS systen 
malfunction. 


e 1/0 Trace 
When to use: Use the I/O Trace to check that I/O interrupts 
are correct during the execution of programs. 


For example, in a multiprogramming system where the status 
of I/o units is suspected of causing incorrect 1/0 
interrupts, an I/O trace output will inform you about the 
sequence of SIO/IO interrupts and about the status of I/0 
units at the time of interrupt. 


NOTE: The added time for this facility may cause a 
failure caused by a timing condition to disappear. 


e FZL Trace | 
When to use: Use the F/L Trace if you are not certain which 
phases are required for a particular program, or in which 
sequence they are called by the program. From the trace 
output you can see where the phases were loaded and their 
entry addresses. In addition you can check the logical use 
of the phases for the progran. 


When to use: Use the GSVC Trace when a particular SVC 
issued by a troublesome program is suspected of causing the 
errors. 


The values of Registers 0 and 1 are printed on the trace 
output and these can be important for certain SVCs. 


The trace output also shows the current PSW at the time the 
SVC was issued. Therefore, the instruction and routine 
issuing the SVC in the program can be located. 


When reading the output from this trace routine you may see 
more SVCs listed than expected. This is because an SVC 
already traced and recorded may be reset by the Supervisor 
SVC routine, and then reissued by the program being traced. 
For example, your program may issue an SVC 0, which is 
traced. But the channel queue may be full at that point in 
time, and so the Supervisor cannot handle the SVC 0. When 
your program has control again it will issue the SVC 0 which 
will be traced again. 


QTAM Trace 

When to use: Use the QTAM Trace to check the sequence of 
STO instructions to the channels and devices. Use this 
trace if you suspect errors in TI/0 interrupt handling 
routines or in program routines issuing SVC 0 and SVC 31, or 
if you suspect errors in the sequence of I/O interrupts 
being returned from channels or devices. The next two 
illustrations are examples of output from a QTAM trace. 


CARED ELS SAE OLR LED TIED EP ES 


When to use: Use the Transient Dump when you suspect errors 
in transient routines. For example, your own error recovery 
routines for devices not supported by IBM. The information 
obtained from the dump will help during offline program 
debugging. , 


Once this progran has been initiated, it is given control 


each time a program check interrupt occurs (except X'11' and 
X*12" program checks) and causes a Transient Dump to occur. 
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2. Some additional troubleshooting hints relative to PDAIDS are as 
follows: 7 


Address of PD area can be found at label PDARPTR. 

Format and contents of PD Area Tables can be found in 
Appendix A of DOS/VS Serviceability Aids and Debugging 
Procedures (GC33-5380). 

Refer to PDAID information in DOS/VS Serviceability Aids 
Logic (SY33-8554). 

PDAREA can be dumped via the AR DUMP command. 

If your customer has not specified PDAID support in his 
Supervisor, an alternate (troubleshooting) Supervisor can be 
assembled and cataloged (with the customer's permission) 
that does contain PDAID support. This Supervisor can then 
be loaded at IPL time whenever there is a need to determine 
and analyze system malfunctions. 


The alternate supervisor must be cataloged under a different 
phasename than the one that the customer normally uses (ie, 
$$A$SUP2). The Supervisor Selectivity feature of DOS/VS 
(Release 29 and later) allows alternate Supervisors to be 
selected at IPL time. 


NOTE: In some instances, dependent on a customer's mode 
of operation, certain non-essential supervisor 
options that are included in the customer's normal 
Supervisor may have to be deleted in the alternate 
Supervisor. 


This may be necessary in order to keep the size of 
the alternate Supervisor equal to or less than the 
size of the customer's normal Supervisor. 


If this situation exists, two or more alternate 
Supervisors can be cataloged, each with different 
normal Supervisor options deleted. In this 
manner, a Supervisor that supports PDAIDS will be 
available for troubleshooting of most customer 
programs. 


Activity (PDAIDS) 


IW: 
UNDER: 
READ: 
UNDER: 
READ: 


DO: 


DOS/VS Serviceability Aids and Debugging Procedures 
Trace Routines (Section 2-B) 
PART 1 - PDAIDS 


Dumps of and Changes to Real and Virtual Address 
Areas (Section 2-A) 
Transient Dump (Section 2-A-4) 


PDAIDS Work Project (In DOS/VS Base SCM 1) 
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Highlights (SDAIDS) 


SDAIDS provide the following functions: 
-~PAGE Tracing 

-INSTRUCTION Tracing 

-~STORAGE ALTERATION Tracing 


-GENERAL REGISTER ALTERATION Tracing 


-SUCCESSFUL BRANCH Tracing 

-STOP and DUMP on EVENT or ADDRESS 

SDAIDS run on any Systemn/370 that supports DOS/VS. 

Minimum of 6K bytes of real storage required for execution 
- called SD area 

- area taken from page pool 


> need not be specified at SYSGEN time 


Initialization requires 12K of real or virtual storage (// EXEC 
SDATID) (After Initialization--SLAIDS does not use any DOS/VS 
services). | 

Control given to SDAID via program check interruptions. (Upon 
return from SDAID--processing continues as if event had not 
occurred). 

SDAIDS run with DAT ‘off' and Disabled for Ivo and External 
Interrupts. 

Only Real area can be dumped with SDAIDS. 

Multiple SDAID events can be traced simultaneously. 

SDAIDS may run concurrently with PDAID routines (Except when 
PDAIDS uses the alternate area for output). 

Program execution time is slightly increased using SDAIDS. 

Output from SDAID is directed to a non-dedicated line printer. 
(The same printer may be used as an output device for other 
programs). | 

SDAID initializing and terminating programs must be cataloged in 
the Core Image Library. | | 


Troubleshooting Hints 


1. 


The following hints identify situations in which the various 
SDAID functions can assist you when determining a DOS/VS systen 
malfunction. , 


e Translation Exception Trace (TE) 
When to use: Use this trace to determine if an instruction 
requires a page to be paged in from the page data set in 
order for the instruction to be completed. An example is an 
MVC instruction whose address 1 is in page frame x in real 
storage, and whose address 2 is in page y that is not in 


real storage. 


When this trace is initialized, any page fault generated 
because of such an instruction is printed along with the 
instruction and its address that caused the page fault, plus 
the output of the specified output class. 
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Page Enqueue Trace (PAGENQ) 
When to uses Use this trace to determine the sequence in 


which programs are calling for pages. Page faults caused by 
translation exceptions will also be traced with this 
routine. 


Page Handling Trace (PAGEHDL) 

When to use: Use this trace to determine the sequence in 
which pages are paged in from the page data set. After a 
page is handled, a trace output is printed. 


Use this trace if you suspect the loss of a page, or the 
sequence of page usage by a program, is causing programming 
errors. 


Instruction Trace (IT) 

When to use: If an unintended loop develops during progran 
execution, this trace can be initiated and the program re- 
run. During this re-run, a list of all the instructions 
executed within the loop will be traced. This is an 
efficient method to obtain a loop trace. 


Storage Alteration Trace (SA) 

When to use: Use this trace if you suspect incorrect 
alteration of I/0 Areas or count locations for loops. 
Information obtained from this. trace will show the 
instructions that are altering the areas. The SA trace will 
not record changes in the contents of locations that are 
changed directly by I/0 channel operations. 


General _ Register Alteration Trace (GA) 

When to use: This trace is similar to the virtual storage 
alter trace. It should be used when information about 
changes to any GR during execution is required to help 
during offline program debugging. Any GR or any combination 
of GRs can be traced. 


successful Branch Trace_ (BR) 

When to use: Use this trace if the actual path taken by a 
program cannot be analyzed from the program flowcharts and 
listings. You can also use it to provide information about 
the path taken, for example, by a long loop. 


stop On Event 

When to use: Use this option if hands-on debugging is 
necessary on the occurrence of one of the specified events. 
For example, when a change occurs in a general register, you 
may want to look through the program listings to enable you 
to decide on the next step in isolating an error. When the 
stop occurs, it is also possible to initiate another SDAID 
routine that will provide additional system information for 
offline program debugging. 


When no time is available for hands-on debugging, the non- 
destroying dumps obtained when the stop on event occurs will 
provide a great deal of information for offline program 
debugging. 
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Stop On Address | 

When and how to use: This facility is used under conditions 
Similar to those for the hardware stop on address compare, 
that is, hands-on debugging is to be carried out when a 
program has reached some specific point during its 
operation. However, this aid enables a stop on all SDAID 
events. 3 


The stop on address is accomplished by initiating the 
instruction trace, specifying stop on event, and entering 
the address at which the stop is required as the address 
supplied within the event limit field during initialization 
of the trace. 


Non-Destroying Dump _(NDD) | | 

When to use: This SDAID facility enables you to obtain the 
information needed for problem analysis without having to 
take dumps of real storage at every occurence of an event. 
Therefore this decreases the amount of paper to be searched 
through during offline debugging. For example, you may 
consider it sufficient for offline debugging to take a dump 
at every twenty-seventh occurrence of an event. 


How to obtain the dump: The following procedure describes 
how to obtain the non-destroying dump. - 7 


1. When the system is in the stop-on-event wait state, 
locate the real storage address of the NDD (non- 
destroying dump) byte switch. The address of this 
program switch is printed during SDAID initialization. 
Refer to the SDAID initialization output (Part 2). 

Ze To ensure that the wait state is the true stop-on-event 
wait, use the ALTER/DISPLAY console feature to display 
the PSW. The instruction address part of the WAIT PSW 
will be OOOOEFEEE. 

3 To obtain the dump, set the NDD byte to X'*FF*', using 
the ALTER/DISPLAY console feature. 

4. Press the START key and then the EXTERNAL INTERRUPT 
key. A non-destroying dump will be printed and 
processing continues. 


When the dump is complete, the NDD byte is reset by the 
SDAID program, and so a dump will not occur at the next stop 
on event. To obtain another dump at any following stop, the 


NDD byte must again be set 'On'. 


Note: The dump can be discontinued by the following 
procedure. 
1. Make the line printer used as SDAID output device 
unready. 
Ze Now make the line printer ready. 


3. Press the EXTERNAL INTERRUPT key two times within 
one second. 
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Dump On Program Check (PGMCHK) 


On the occurrence of program check interruptions xX'Q1' -. 
X'OF',xX'10', and xX'12', a non-destroying dump occurs 


automatically (unless 'No' is specified as a response to 


message 4C67D during SDAID initialization). 


After this automatic non-destroying dump is executed, the 
DOS/VS program check handler routine is entered. | 


When to use: If PDAIDS are not available on your systen, 


the use of the SDAID ‘dump on program check! option is the 
only way to obtain a non-destroying dump of the Supervisor 
transient area at the time of of a program check interrupt. 


2 Some additional troubleshooting hints relative to SDAIDS are as 
follows: | 


The addresses of the beginning and end of the SD Area and SD 
Buffer are printed on the device assigned to SYSLST during 
initialization of SDAID. Refer to SDAID Initializing Output 
(Part 1). 


Altering SDAID functions and/or address limits after 
initialization. After SDAIDS have been initialized, trace 
functions and events limits, where applicable, can be 
changed by altering SDAID program parameters directly in 
storage. The contents of the parameters at the addresses 
printed on Part 2 of the SDAID Initializing Output, and of 
Control Registers 8, 9, A, and B can be altered. 


To make SDAID parameter changes: 


Press the STOP key. 

Use the console ALTER/DISPLAY feature to alter 
the contents of the program parameters, 

Press the START key. 


NOTE: When SDAID is terminated and later re-initialized, 
new SDAID parameters are printed in the SDAID 
initializing output. 


NOTE: SDAID requires SYSLST for the initializing output. 
Therefore, if you intend to change SDAID 
parameters after initializing SDAIDS, you should 
ensure that the SYSLST device is a line printer on 
the partition used for SDAID initialization. 


If it is ever desired to reduce (or limit) the size of the 
available page pool for any reason, SDAIDS can _ be 
initialized with the desired amount of reduction specified 
in response to message 4C55D (minimum of 6K) and no events 
Specified (press END key for all event messages except 
PGMCHK, to which respond with NO and END). This procedure 
can also be used to maintain SDAIDS in storage in an 
inactive state until needed (alteration of parameters in 
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storage, via the console, can then be used to activate any 
desired event(s). 


@e Address of SDAID SAVE AREA (in Supervisor) can be found in 
SYSCOM at offset xX'88!. 


Activity (SDAIDS) 

IN: DOS/VS Serviceability Aids and Debugging 
Procedures 

UNDER? Trace Routines (Section 3) 

READ: PART 2 -— SDAIDS 

DO: SDAIDS Work Project (In DOS/VS Base SCM 1) 


Highlights (SY¥SVIS_DUMP) 


@ SYSVIS DUMP initiated by // EXEC PDSDM. 
e Can copy page data set to tape, disk or printer. 
e PDSDM can selectively dump the following: 
- the entire PDS (all of the VIRTUAL address area) 
- any specified VIRTUAL partition 
- one or more pages contained within any VIRTUAL partition 
® When dump is from Page Data Set: 
- SYSO0O00 must be assigned to SYSVIS (Input Device) 
- SYS001 can be assigned tc tape or disk (Output Device) 
OR | | 
- SYSLST can be assigned to tape or disk or a line 
printer (Output Device) 
e When dump is from intermediate storage (SYS001) 
- SYS0O01 must be assigned to the input tape or disk device 
- SYSLST can be assigned to tape or disk, or a line 
printer (Output Device) 


® If a tape or disk device is used for input or output - label 
information must be supplied in the job strean. 

e SYSVIS dump format similar to that of a standalone dump. 

@ Can be initiated via SYSLOG or SYSIPT. 
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Troub bleshooting Hints (SY 


DUMP) 


When to execute the dump: It is recommended to obtain a dump of 
SYSVIS whenever a standalone dump is executed. A SYSVIS DUMP 
should not be executed until a standalone dump has been taken, 
and should then be initiated during the system re-IPL. To help 
with your analysis of the information contained in the SYSVIS 
dump, it is also recommended to execute a formatted stand-alone 
dump. For this reason, execution of a SYSVIS DUMP is included in 
flowchart A-3-F ("Executing the Stand Alone Dump') in Section 2 
of DOS/VS Serviceability and Debugging Procedures. 


How to use the dump output: 


During analysis of a system malfunction (such as a HARD WAIT 
STATE) using a standalone dump output, it may be necessary to 
analyze the coding in a page belonging to a virtual partition 
which was not in real storage when the standalone dump was 
executed. 


Virtual address allocations can be obtained from the BOUNDARY 
BOX, and pages not in real storage can be found by analyzing the. 
contents of the PAGE TABLE in the standalone dump. The format 
and contents of the boundary box and the page. table are described 
in Section 4, Chapter 12 of SADP. 


The SYSVIS dump should then be used in conjunction with the 
Standalone dump output. It is recommended to always use a 
standalone dump generated with the DUMPGEN parameter FORMAT=YES. 
DUMPGEN is described in A-3 of Section 2 in SADP. 


It is essential that the operator save the copy of the PDS after 
executing the standalone dump. You as the system programmer, or 
the IBM CE/SE will then be able to print out all Or any part of 
the PDS to complete problem analysis. 


IN: DOS/VS Serviceability Aids and Debugging 
Procedures 

UNDER: Library Display Programs and Utilities 
(Section 2) 

READ: 


SYSVIS DUMP (Section 2-~-C-6) 


SELF-EVALUATION QUESTIONS 


1. 


2 


(True/False) The page pool is reduced by a minimum of 6K 
whenever PDAIDS are successfully initialized. 

QTAM Trace entries (can/cannot) be listed on ae line 
printer. 


ap WanPen® ee 
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11. 


12. 


13. 


14. 


15. 


16. 


17. 


18. 


The PDLIST program will process a PDAID output tape when the tape 
is mounted on a tape drive assigned to symbolic unit es 


(True/False) The I/O Trace routine PDAIDITW (when initialized) 
will be located in the PD Buffer area of the PD area. 


The POINTER to the PD Area in a DOS/VS Supervisor listing has the 
label and is located in the 


ESEES CUEESY EEE SERED CLES OLED CED AT RD ese ewes. ne ae eae Rares aaeeee GREED Gribeias aio wa 


Indicate, in decimal, the byte lengths of the following areas in 
the PD area: 


PD Address Table 
PD Standard Preface Table 


TEESE 


The name of the phase (routine) that will be in the event 
handling routine area of the PD area when the PDAID Transient 
Dump function (output to tape) has been initialized is 


e 
ED GED RD PEPE coh CED GSA AID GAN AP ETD GED 


If an output device has been identified during ’ PDAID 
initialization, its address can be found in bytes __ to 
sete eaten ee NO RN 5 Be ce et ee table. 

The address of the last byte in the PD Area can be found in bytes 

sitet ROMs atic oo tne OE OO ce en eis, table. 

If an alternate area (AAA) has been specified for core-wrap 
output, it can be dumped prior to termination of PDAIDS via the 
job control command using the operand. 


ED ELD EAD TGS CTD EE Carbs eee cae 


The starting and ending addresses of the alternate area can be 
located in bytes to and to _ of the 


AE EES ES a ED ED CN GRID aD 


(True/False) SDAIDS and PDAIDS can not be active (initialized) 
in a DOS/VS system at the same time. 


(True/False) ALL SDAID events can be traced simultaneously. 


(True/False) If 'GO' is specified for message 4C58D during SDAID 
initialization, only dedicated SDAID events will be traced. 


Alterations to GPRs 1, 5, 9, and 13, as well as all BR events are 
being traced via SDAIDS. Control Register 9 (CR9) will contain 


(True/False}) Segment, Page, and Page Frame Table contents are 
not output when SDAID event defaults are taken. 


(True/False) Non-destroying (NDD) and PDUMP can only be obtained 
from SDAIDS if a YES reply is given to message 4C60D. 


The SDAID phase that resides in the alternate area during SDAID 
execution is __ : 


FMR ELE SELLE ES AO TEEES CSE IED 
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19. 
20. 


21. 


226 


(True/False) SDAIDS can only be terminated when Job Control is 
active. 


(True/False) Output classes (OUTCL) 01 through 08 aust be 
obtained for SDAID dedicated events. 


The logical units that are used during execution of PDSDM are: 
SYS___ =SYSVIS_ 
SYS___=Tape or disk input/output unit 
SYS___=Line printer output unit 


(True/False) Initialization of SDAIDS (//EXEC SDAID) on the 
DOS/VS Base lab system with the following parameters will cause 
a dump of the LTA each time a $$B phase (logical transient) is 
loaded (SVC2). 


OUTPUT DEVICE=(END KEY) 

STOP ON EVENT=(END KEY) 

EVENT LIMITS=X'006817',X'006817" (END KEY) 
OUTCL=PDUMP, X'006810', X'OO06CBF" (END KEY) 
EVENT BR=(END KEY) 

EVENT IF=(END KEY) 

EVENT SA=YES(END KEY) 

EVENT GA=(END KEY) 

EVENT TE=(END KEY) 

EVENT PGMCHK=NO,GO(END KEY) 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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DOS/VS_DOCUMENTATION AND OLTEP 


This topic familiarizes the student with the various types of support 
documentation that are available in the DOS/VS Library (i.e, 
Descriptive, Reference, and Logic manuals). 


The documentation familiarization process is employed as a vehicle to 
instruct the student in the concepts and usage of the On-Line Test 
Executive Program (OLTEP). 


Instruction on the use of microfiche is also covered. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: | 


1. Locate information relative to any given function or aspect of 
DOS/VS in the following support documentation: 
- SRLS 
- Pins  — Aaigam Kaw Wega 
- Bibliography 
- Microfiche 

Ze Use the OLTEP SRL to initialize OLTEP. 

3. Use the PDAID FETCH/LOAD Trace function to observe the phases of 
OLTEP and OLTS that are called when executing the 1403G test of 
OLTEP. 


Highlights 


® The IBM System/360 and System/370 Bibliography can be used to 
7 determine which manuals pertain to any given function or aspect 
of DOS/VS. 


® SRLs contain “externals" reference information. 

@ PLMs contain "internals" logic information. | 

@ Microfiche reduces the volume of hard copy listings required for 
DOS/VS support. 

@ OLTEP always executes REAL in BG. 

e OLTEP requires a minimum partition size of 14K (18K if RETAIN/370 

| active). 

® OLTEP, CDS and OLTS must be cataloged in the core image library 
before IJZADOLT can be executed. 

e OLTEP is a SYSGEN OPTION. 
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Activity 


IN: DOS/VS OLTEP SRL 
READ: Module 1 and Module 2 
IN: DOS/VS OLTEP Logic 
UNDER: CHARTS 

STUDY: CHARTS OO and 01 


SELF-EVALUATION QUESTIONS 


1. 


To locate the SUBJECT CODE LISTINGS for DOS/VS publications in 
the IBM System/360 and System/370 Bibliography, which of the 
following should initially be referenced in the Bib? 


ae Part 2 

b. The Index 

Ce The Preface 

d. The Contents Page 
e. Part 4 


What is the form number of the publication that is referenced in 
the last paragraph of the Abstract for the DOS/VS BTAM LOGIC 
manual? (BTAM is an ACCESS METHOD). 


ae GC27-6989 
be SY27-7251 
Ce SY27-7249 
d. GC27-6986 


ee GC27-6985 


(True/False) All DOS/VS Control Program Logic manuals have form 
numbers that begin with SY33. 


Select the answer that indicates the correct statement to use 
when initializing OLTEP. 


ae Sf EXEC PGM=OLTEP 
De J// EXEC IJZADOLT 
Cx J// EXEC OLTEP > 

d. // EXEC PGM=OLTS 
e. None of the above 


Which detail chart in the OLTEP PLM contains the routines that 
determine which device test(s) are to be executed? 


Ae 01 
b. 00 
Ce AH 
d. AE 
e. AK 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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PROGRAM SUPPORT RESOURCES 


This topic addresses the responsibilities of a PSR and acquaints the 
student with the various support resources ("tools") that he has 
available to carry out these responsibilities. The functions of the 
FTSC, SDD Change Teams, the ACRE System, RETAIN/360 and RETAIN/370 
Systems are presented. Use of the PSGI Handbook and APAR submission 
are also covered. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. State the function and/or mission of any of the following given 
Program Support Resources: 
- FTSC 
- PTF 
- APAR 
- SDD Change Team 
- ACRE System 
~- RETAIN/360 and RETAIN/370 Systems 
- EWS 
- PSAL 
- PLTR 
- Central Programming Service (CPS) 
- Education Update 
- FSS/ANSWR 
Ze Prepare an acceptable APAR for submission to the proper SDD 
Change Team based on your analysis of a given T/A Problem during 
the lab portion of the course. 
3. Interrogate the RETAIN/360 System for any given programming 
information related to a specific component and release level. 


Highlights 


® Activities and responsibilities of the PSR are fully supported by 
the FTSC, SDD Change Teams and Field Support organizations. 

@ The RETAIN/360, RETAIN/370, ACRE and FSS Systems are utilized to. 
provide the PSR with comprehensive and timely programming 
information. 

e The PSGI Handbook (2225-0511) is an invaluable reference "tool" 


to the PSR. 
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Activity 


IN: Programming System General Information Handbook 

UNDER: SECTION 1 

STUDY: ALL, and become familiar with the contents contained 
therein. 

UNDER: SECTION 2 

READ: PSMs 2, 4, 12, 16, 20, 23, 26, 27 and 34 


SELF-EVALUATION QUESTIONS 


1. 


Select the answer that correctly identifies the most proper 
sequence of events that should occur to Oe resolve a 
customer reported Severity 1 programming problen: 


ae Customer calls FTSC, PASS Search, Component Specialist 
writes APAR, APAR entered in RETAIN/360, PTF or circ 
cumvention fixes problem, PSR obtains APAR status from ACRE. 

b. Customer calls PSR or 8B.0O., Problem Determination, PASS 
Search by FTSC Component Specialist, Fix applied by PSR, 
APAR submitted by PSR, ACRE response entered into 
RETAIN/370. 

Ce Customer calls, Dispatch Systems Engineer, SE calls 
Component Specialist, Specialist submits APAR to _ ACRE, 
Change Team develops PTF, PTF entered on FSS/ANSWR, PSR 
obtains PTF from FSS/ANSWR and installs. 

d. Customer calls CE, Dispatch Programming Systems 
Representative, FTSC PASS Search, APAR Abstract entered in 
RETAIN/370, APAR placed in ACRE, FSS/ANSWR of ACK, 
circumvention fixes problem, permanent fix for problem 
occurs via PTF from Change Tean. , 

eC. Customer calls SE, Dispatch PSR, PD occurs, FTSC PASS 

_ Search, APAR Abstract entered in RETAIN/370, APAR placed in 
ACRE, FSS/ANSWR of CAN, Customer discontinues service. 


When submitting an APAR for DOS/VS because of an abnormal 
termination due to a program check, the FAILURE SYMPTOM keyword 
that should be used on the APAR form is: 


ae ABENDPCK 

b. PROCCHK 

Co SUPVR 

d. WAIT 

Ce None of the above 


To obtain terminal printouts of all DOS/VS Release 29 PTF Cover 
Letters from the RETAIN/360 System for the period of 06/01/74 to 
the current date, the correct PIN PROGRAM REQUEST entry should be 


To obtain up-to-date information for SYSGEN planning (from 
RETAIN/360) prior to an SCP installation of DOS/VS Release 29 
(ie, minimum EC levels, etc), the correct PIN PROGRAM REQUEST 


entry should be Le ee ee, ee eT ie 


Refer to the Contents for the location of the self-evaluation question 
answers. 


This topic will introduce the need and present an overview of an SCP 
installation. This topic will build the foundation for all_ the 
following installation topics. The pre-installation planning portion 
of an SCP installation will be shown. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1s State in his own words, the four stages of an SCP installation 
and the PSR's responsibility for each stage. 

2. Identify the resources available to the PSR _ for an SCP 
installation. 

3 Identify the steps of planning and generating a SCP. 


Highlights 
® The PSR will install an unaltered SCP. 
@ The PSR responsibility during the pre-installation planning 


session is to ensure that RAS areas are addresses and any known 
problems are fixed. 
® The following items are useful to the PSR during the SCP 

installation: 

- Memo to user 

- Program Status Document 

- SYSGEN SRL 

- System Management Guide SRL 

- FE Education Release Update 

- Planning SRLs 

- EWS 

- PSAL 

-S/360 RETAIN 


Activit : , : ~ oo | 
_ . dir DGVS SYST MANROENT GUDE —~lrop S Fala Ly a “yo ler . 
IN? DOS/SVS SYSGEN SRL | 
UNDER: Module 1: PLANNING and PROCEDURES#T SY 
READ: Introduction 
through 
System Configuration 
READ: Planning an Operation Pack 62 
through . z 
System Directory and Library Track Capacitiesé 
IN: DOS/VS SCM 1 


READ: Introduction to SCP Installation 


e Use the Console ALTER/DISPLAY feature and/or Standalone 
Dump Program to print out storage at a given point during 


IPL. 
IPL from a different physical device. 
Use a different SYSRES (if available). 


STUDY: 


DOs: 


DOS/VS IPL and Job Control Logic 
Introduction 
Initial Program Load (IPL) 


IPL Program 
$$ASIPL1 and $$A$IPL2, Chart 01 
$IPLRT2, Chart 02 
$IPLRT3, Chart 03 
S$IPLRT4Y, Chart O04 
S$IPLRTS, Chart 05 


IPL Figures in DOS/VS Base SCM 1 


PART 1 (IPL) of WORK PROJECT O 


SELF-EVALUATION QUESTIONS 


Vs The IPL phase $$A$IPL2 is located on the system residence pack at 
disk address: 


Ae 
b. 
Ce 
d. 
e. 


© 
i) 
© 
oS 
GQ) NO = U1 Ul 


2% The IPL program builds and uses a two-device system. The IPL 
two-device system consists of what symbolic units? 


Ae 


be 


Ce 
d. 


ee 


SYSRDR 
SYSIPT 
SYSLOG 
SYSRES 
SYSUSE 
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The following figure will be referenced by questions 3, 4, and 5. 


LUB TABLE PUB TABLE 
LO 00 SYSRDR PO 00. OC 
L1 00 £SYSIPT P1 = 00~—t—é«OOW 
L2 01  #£SYSPCH  -p2—s-00-—t—«O#EF 
L3 02  #£SYSLST P33 00.~Ctsa1F 
L4. 03 SYSLOG PH 00Ssé2B 
L5 06 #£SYSLNK PS «—(01s«98200 
L6 05 £SYSRES P6 4201-—Cis*9' 
L7 O04  SYSSLB P7 01. 80 
L8 04  SYSRLB PS 02~S—éDB8‘ 


L9 00 SYSUSE 
L10 0O7 SYSREC 


Figure 1 


If the IPL control statement that follows was processed by IPL, 
the physical device address would he placed in the PUB Table 


(Figure 1) at location ___ _ CeO ADD COX*021", 2400T9 
ae PY 
b. P5 
Ce P8 
d. P9 
e. PO 


If the preceding ADD card had heen processed, the LUB entries (as 
shown in Figure 1) that must be updated are: 


b. LO, L1, L2, L3, LY, Li, L8, and L9 


Ce L6 
d. L5 and L6 
e. None of the above 


If the following DEL card was processed by IPL, what LUB entries 
(as shown in Figure 1) must be updated, if any? 
DEL X*O2B! 


ae L5, L6, and L10 

De LO, L1, L2, L3, L4, and LI 
Ce L5, L6, L7, L8, and L10 

d. L7 and 18 

Ce None of the above 


Including the IPL bootstrap routines, there are a total of how 
many IPL phases? 


ae 5 
b. 6 
Ce 7 
d. 2 
e. 1 
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ey QUESTIONS 


1. 


List the font stages of a SCP installation 


ae 


DATED ILD GT CUTTY CAEN AED CBRNE PERS 


b. 


Ce 


The maintenance integrated into a PID system is documented in the 


@ 
ET LGD LETTE LLELLED SEINE 


The first item decided when planning the SCP is __ ° 


After the SCP is installed, the should be updated 


to indicate the PTFs applied to the. system. 


Refer to the Contents =Oe the location of the self-evaluation question 
answers. | 
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PID SYSTEM 


This topic will discuss the content of the PID system as received by 
the user. Included will be the initial format of the disk or tape and 
the documentation received with the systen. 


The initial use of the PID system to begin the installation procedure 
will also be discussed. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Create the control cards necessary to create a SYSRES pack from a 
PID tape. 

2. Given a message from the distribution program, perform the 
necessary corrective action. 

3. Given the control cards, perform the steps necessary to create a 
SYSRES pack from a PID tape. 


Highlights 


® The Distribution Program will initialize disk and restore the PID 
system tape to disk. 

e The SYSRES libraries can be allocated when SYSRES is first 
created. 

@ The customer will punch up the cards necessary for the SCP 
installation. 

e The initialize disk program can be bypassed. 

® The DOS/VS System Generation SRL contains several examples of 


system generation. 


Troubleshooting Hints 

@ The distribution program messages are in the DOS/VS Systen 
Generation SRL and not in the DOS/VS Messages SRL. 

® If you are not sure about a local fix working in the supervisor, 


catalog the supervisor under the name $$A$SUP2. When you are 
sure it is working correctly, rename it $SA$SUP1. 


© Keep all printouts from the SCP installation on site in a 
correctly labeled folder. 
e Follow the SCP procedure in the SYSGEN SRL as closely as 


possible. 


Activity 


IN: DOS/VS System Generation SRL 
UNDER: DOS/VS Distribution Program JOB CONTROL 

Coding Specifications 
READ: DOS/VS Distribution Program JOB CONTROL 

Coding Specifications 

through 

End of Section 

READ: IBM 2314 Direct Access Storage Facility Example 


through 
2314 Example: Result of System Generation 


SELF-EVALUATION QUESTIONS 


1. 


2 


3. 


4. 


The recommended location of the VTOC on a 3348/70 MB SYSRES' pack 
is cylinder 


The message S302W is caused by detecting 


LD ARR SEED CRANES AE SEOUL NS LOE SENS ETD 


ED CEN CE EN CAS oe CD ae ay SES ori GET GE CEP CEASE OD EY A AE 


The format of the FILES statement to bypass initializing of the 
pack is | ° 


The name of the DOS/VS system utility program used to back up the 
SYSRES is __ 3 


AS HSLDA SEED PES EE LPP IS ENS CED GD KE SE ET CaS CPC OAS AD ee i RE PD 


Refer to the Contents for the location of the self-evaluation question 
answers. | 
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INITIAL PROGRAM LOAD (IPL) 


This topic teaches the student how to separate program errors from 
operator errors during system initialization. His knowledge will be 
applied to PLM flowcharts to see the steps taken by the programs’ to 
accomplish IPL functions. In the lab, problems which cause incomplete 


or 


incorrect operation will be isolated using PLMs, microfiche, and 


storage dumps. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: | 


1. 


26 


Follow a PLM flowchart and record on paper all changes made _ to 
LUB and PUB tables when an IPL control statement is being 
processed. 

Identify the failing instruction or group of instructions causing 
incorrect operation of the IPL program. Show the failure in a 
core dump, microfiche listing, and a PLM. 


Highlights 


IPL is the only time during which devices can be added or deleted | ©} 
from the PUB table (with the exception of generating a new 
Supervisor). 

IPL determines real storage size. 

IPL loads the Supervisor. 

IPL identifies the Communication Device. 

IPL builds LUB and PUB tables. 

IPL assigns SYSRES, SYSCAT (if present), and SYSVIS. 

IPL initializes DAT. | 


Troubleshooting Hints 


“= aneeT,eaeem 


Investigate all error messages in the DOS/VS Messages Manual. 
Use Error Message Cross-Reference in the PLM in conjunction 
with the detail PLM charts to determine why an error nmess- 
age was issued. 

Use the charts to determine why an error message was 

issued. | 

Use the diagrams in the PLM to determine where elements of 
IPL should be in storage at a given point during IPL. 

Use the CPU address Stop feature to halt the IPL process 

at a given storage address. 


10. 


11. 


12. 


13. 


What phase of IPL would process the following control statement? . 


SET DATE = 03/29/68,CLOCK=20/00/00 


ae SIPLRT3 
b. SIPLRT2 
oo SSASIPL1 
ad. S$$ASIPL2 
e. None of the above 


(True/False) The INITPT routine is called by IPL phase S$S$A$IPL2. 


The name of the program that determines the storage size of the 
CPU is: 


a Problem program 


b. Supervisor 
Ce Job Control 
d. IPL 


e. None of the above 


The extent of a 2314 SYSVIS for a DOS/VS system that has 1026K of 
virtual address space will encompass _... tracks. 

(True/False) It is not necessary to issue the DPD command during 
IPL of a DOS/VS system if the DPD macro has been specified at 
system generation. 


(True/False) After $IPLRT5S is executed, $BEOJ will always be 
called. | 


(True/False) $IPLRT2 clears storage above itself to the end of 


real storage. 


Refer to the Contents for the location of the self-evaluation question 
answers. | | | 
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DOS/VS_ LIBRARIAN PROGRAMS 


The use of the librarian programs will be discussed in this topic. 
The use of these programs will be required in the following topics. 


Also to be covered is the application of any PTFs to the £E.Books 
before generating the Supervisor or POWER. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able tos: 


1. Use the correct maintenance program to display any given 
directory. 

2 Use the correct maintenance program to display or punch any given 
library entry. 

3. Identify the correct librarian program to catalog any given 


entry. 
Highlights 
e The Librarian is a group of programs that organize, maintain, and 
service the libraries and directories of a DOS/VS resident systen 
and private libraries where desired. The Librarian has_ three 
types of programs: 
- Organization programs 
= Maintenance programs 
= Service programs 
@ The organization program is fetched by Job Control when the 
// EXEC CORGZ control statement is read. Its major func- 
tions are to: 
~ create private libraries 
- copy SYSRES either selectively or completely 
~ . merge from one library to another, either selectively 
or completely without having to generate punched card 
output and recatalog 
- It can also redefine the number of tracks and cylinders 
allocated to libraries and directories. 
@ The Maintenance programs are fetched by Job Control when a 


// EXEC MAINT control statement is read. Its major func- 
tions are: ' 
- catalog function for all libraries 
NOTE: The core image library catalog function is per- 
formed by $MAINDIR, which is called SLNKEDT. 


- Delete function for all libraries 
- rename function for all libraries 
- reallocate function for all system libraries 


- condense function for all libraries. 
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The Service programs are fetched by Job Control when a // EXEC 


(DSERV, CSERV, RESERV, SSERV, or PSERV) is read by Job Control. 


The functions are: 

- Directory service program (DSERV). Displays the contents of 
the directories in SYSRES and the private directories. All 
directories can be displayed in a single run, or they can be 
displayed selectively. 


- Core image library service program (CSERV). Displays and/or 
punches phases fron the system and/or private core image 
library. | 

- Relocatable library service program (RSERV).. Displays 


and/or punches modules from system relocatable and/or 
private relocatable libraries. 

- Source statement library service program (SSERV). Displays 
and/or punches books from the system and/or private source 
statement libraries. 


- Procedure library service program (PSERV). Displays and/or 


punches procedures from the system procedure library. 
Before you can put a macro definition on the macro library, the 
assembler has to edit it and, using the EDECK option, produce an 
edited macro deck. The edited deck is placed on the macro 
library using the MAINT program. An edited macro definition, 
either in card format or on the copy library, is updated. After 
the changed macro definition has been tested, debugged, and 
edited, it can be placed on the macro library. 
If your source macro definition is not available, the de-editor 
program, ESERV, can be used to de-edit the edited macro . 
definition to source format. Several macros can be handled at 
one time. The de-editor program also combines the function of 
de-editing with that of updating the Source macro definition. 
The ‘'copy' library contains A.BOOKS. | 
The ‘macro! library contains E.BOOKS. 
The Source Statement Library contains the ‘copy and the ‘macro! 
library. 


Troubleshooting Hints 


Maintenance of the system, in certain cases, causes the 
directories to be incompatible with their corresponding lib 
braries. These cases occur, in particular, when the reallocation 
program (MAINTA) and the condense program (MAINTCN) are being 
executed. If the execution of either of these programs is not 
completed, the status of the system is unpredictable and the 
system may have to be rebuilt. It is therefore imperative that 
during the execution of either program, the supervisor be 
prevented from fetching any phase. To safeguard against these 
incompatibilities, PIOCS performs the following: 

- masks attention if bit 6 of the linkage control byte 
(displacement 57 of the communications region) is on. This 
bit is turned on and off by both programs. 

- enters the system into a ‘hard wait' when an I/0 error 
occurs on SYSRES, or when updating the core image library. 
The indication '‘XFF6' is then set in register 11 and is 
stored in low real storage. 
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Cataloging a new book to the Source Library when an old book 
(same name) already exists in the library can cause unique 
problems. The directory entry for the old book is deleted before. 
the new book is cataloged. If the maintenance function runs out 
of room in the library during the catalog, both old and new books 
are lost. A condense of the library may be required before’ the 
catalog will occur. 


Activity 

IN: Guide to the DOS/VS Assembler 

UNDER: Maintaining the Macro and Copy Libraries 

READ: The whole section 

UNDER: De-editing and Updating Macros: ESERV Program 
READ: The whole section 

IN: DOS/VS System Control Statements 

UNDER: Librarian 

REVIEW: From beginning to CSERV, Core Image Library 
REVIEW: The figures 'Maintenance Functions, Example' and 


'Service Functions, Example! and 'Copy Function, 
Example! 


SELF~EVALUATION QUESTIONS 


1.) 


2. 


Se 


To determine the relocatable modules present in a library, the 
function would be used. 


To punch a macro from a private source statement library, it is 
necessary to ° 


(True /False) The Service programs supply the catalog function 
for the relocatable library. 

To create a private library, the program would 
be used. 


| 
The maintenance program to catalog a program into the Core Image 
Library is called by // EXEC ° | 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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SUPERVISOR GENERATION 


This 


topic will discuss the generates of the tailored supervisor as 


specified by the user. 


All parameters will be discussed and the SCP to be generated in lab 


will be introduced. 
OBJECTIVE 
Upon completion of this topic, the student, using the available 


documentation, should be able to: 


1. Correct any given error in the macros used for Supervisor 
generation. 

2 State the importance of the RAS parameters for problem 
determination. 

3% Correct any given errors in the catalog job stream for Supervisor 
and maintenance programs. 

Highlights 

® The DOS/VS Supervisor is assembled using thirteen (13) macros. 

® The functions required in each unique installation can be 
selected by proper coding of the macro paraneters. 

e Consideration must be given to the programs which will be used 
with the tailored supervisor. Fxamples: 
sa COBOL requires AB=YES 
- Some utilities use SYS010. If these are not 10 entries 

in the LUB table, the program cannot be executed. 

- . FORTRAN and PL/I require floating point in hardware and 
| FP=YES in the CONFG macro. 

@. Multiple supervisors can be assembled and cataloged, each having 


different parameters. 


Troubleshooting Hints 


If the user doesn't have enough storage to include RAS items in 


the Supervisor: 


- Generate another Supervisor of the same size, omitting 
enough items to add the aids and replace the phase card with 
a unique name before cataloging. 

To save time during the catalog of the new Supervisor, the phase 

card can be changed to $$A$SUP2 before cataloging. If the new 

Supervisor won't IPL, the PID Supervisor is still available. 

When the new Supervisor is checked out, use RENAME to change name 

to $$A$SUP1. 
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e Check the following items carefully during a SYSGEN: 

- all MNOTES during Supervisor assembly 

= any error message 

= the LINK MAP during all catalog operations 
Activity 
IN: DOS/VS System Management Guide. 
UNDER: Chapter 3: Planning the System 
REVIEW: From beginning to ‘Generating a Version of POWER’ 
IN: DOS/VS System Generation 
UNDER: Module 1: Planning and Procedures 
REVIEW: System Configuration 
REVIEW: The Supervisor/Generation Macros 

through 
Maintenance Procedures 

UNDER: IBM 2314 Direct Access Storage Facility Example 
REVIEW: Steps 8, 9, and 10 


SELF-EVALUATION QUESTIONS 


The SEND macro, when specified without an address will 


ETA ELD AEA Dy CELE CEP SID PLD EEE LIED OLLI TELL TELL E EN LE ELLIE LED OLE IOS LETS LLL LED LEY SEED EY LEED LOTS CA ET A LS A AD aS TE A ND SD AS OE 


The PUB table entries are built from the _ __.. macro. 


To specify DASD file protection for a system with 3330s on 
channel 1 and 2314s on channels 2 and 3, the FOPT macro would 
roo} Uo. 5s 0 | a a co ee oe a ae ae ee ee ee ° 

(True/False) If the default values for the standard Job Control 
macro are correct, the macro can be omitted from the SYSGEN 
deck. | 


RMS support is standard for all 370 CPUs except eu 
To generate RMS support for these CPUs, the _ _. macro 
parameters Joodig _ _¢ and are used. 


(True/False) The SYSGEN macros may be submitted in any order. 


To assemble a supervisor and catalog it to the Core Image 
Library, label information is required for what logical units? | 


EP TNS AD RAED ERE AENS CD SMO CLY GYRE AY AAS SRY CEA MEELIS GAPS ENE EI LETS LLP IT CRED EE LEED LED LATS SLD 


9. The key librarian programs must be linked at the same time as the 
new supervisor if 


i e 
ER CEES SAL A GRUP CAGE CATER CHAD ERS CES STATE TE GE EES PATS CE? 


Refer to the Contents for the location of the self-evaluation 
questions answers. 
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INSTALLATION VERIFICATION PROCEDURES (IVP) & 


The Installation Verification Procedures (IVP) for the DOS/VS SCP will 
be covered in this topic. In the lab, during the installation, the 
students will operate the IVP to verify the SCP installation. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Assemble and operate the IVP program to verify that an SCP has 
been installed correctly. 

2 Code the IVPGEN macro to create an IVP job stream to verify any 
DOS/VS SCP. 


Highlights 

@ The IVPGEN macro will generate the necessary job streams to 
verify the SCP installation and delete unused IVP books. 

@ The IVP procedure is a two-stage process, the first stage 


consisting of assembling the IVPGEN macro to create the IVP job 
stream and the second stage is running the IVP job strean. 


Troubleshooting Hint 


CED CUED Te CGE aT 


@ Use VERIFY=YES parameter for the first compile of the IVPGEN 
macro. 

@ The SYSGEN manual contains printouts of the stage II IVP run. 

@ Tf a function is added to the system after the IVP stage II run, 


the RERUN parameter will create an IVP job stream to check out 
the new function. . 


Activity 


IN: DOS/SVS System Generation SRL 
READ: MODULE 3: INSTALLATION VERIFICATION PROCEDURE 


SELF-EVALUATION QUESTIONS 


1. 


Ze 


The IVPGEN macro operand that causes a job stream to be created 
that will delete all IVP books not used in the assembly of the 
IVP macro is : 


The stage II IVP job stream requires _ K of real storage 
allocated. 


Refer to the Contents for the location of the self-evaluation question 
answers. | 
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JOB CONTROL 


This topic teaches the student the purpose and structure of the Job 
Control program. The loading sequence of the various job control 
phases and the specific functions performed by each is presented. 
Through the use of PLMS, microfiche, and storage prints, the student 
will learn to locate key areas and information within the progran 
code. This knowledge will be used in lab to analyze and isolate job 
control problems that cause incomplete or incorrect system operation. 
Generic device assignment is also presented during this topic. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


eae 
Bo State which phase of job control is required in storage for the 
% oe processing of a given JCL statement or command. 

Ze Identify, in a storage print, the phases(s) of job control that 
were in storage at the time the dump was taken and the systen 
addresses at which they were loaded. 

yen ~-, Interpret the contents of a given JCL phase vector table entry. 
ea Using a DSERV of the core image library directory, calculate the 
size of a given JCL phase. 

5., Determine the failing instruction, or group of instructions which 

“cause incorrect execution of the job control program. Identify 
the failure in a storage print, microfiche, and PLM. 


Highlights 


os. Job Control provides job-to-job transition for all programs. 

ws Job Control always executes in virtual mode. 

y Job Control is a multiphase progran. 

“e $JOBCTLA is the root phase of the Job Control program. A portion 

oe of this phase is always in storage during execution of job 

control. 

cA The phase vector table (within $SJOBCTLA) determines which JCL 

phase is needed to process a specific JCL statement or command. 

® $JOBCTLA is loaded into a virtual partition at the termination of 

vil an executing program by $BEOJ. 
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PRD ATER SALLE 


Se NG Se 


ESD EES CUS ETE i Oe 


Investigate all JCL error messages. 

Use Error Message Cross Reference in the PLM in conjunction with 
the general and detail PLM charts to determine why a JCL error 
message was issued. 

Inspect the last character of the job control phasename in a dump 
to determine the JCL phase that is in the root phase overlay 
area. 

Use a core image library directory DSERV to determine the length, 
load point, and entry point for any phase of job control. 


e, Reference the phase vector table in $JOBCTLA to determine the 

74 required JCL processing phase for any valid JCL statement or 
y command argument. 

e’ Use labels in the JCL detail charts (in the PLM) as a means to 

locate specific areas of code in the microfiche to be 
investigated. 

Activity 

IN: DOS/VS IPL and Job Control Logic 

READ: Job Control Program 

IN: DOS/VS Base SCM1 

READ: The Generic Assignment Section 

DO: PART 2 (Job Control) of WORK PROJECT 0 


SELF-EVALUATION QUESTIONS 


1. 


a SE a a re 


The Job Control phase that will process an ASSGN statement is: 


a. $JOBCTLA 
b. $JOBCTLI $ JORCTLD 
c. $JOBCTLK 


d. $JOBCTLG we 
e. None of the above 


Indicate True (T) or False (F) for each of the statements below 


concerning the following phase vector table entry: 


C1D3D3D6C3D9401740D1 0001 O11} O10 dove 


x a The entry is for the ALLOC operation. 
b. The required processing phase is $JOBCTLJ. 
—~X Ce The required phase will be entered at a displace 
ment of 40 bytes from its origin address. 


d. Processing is to occur even though a cancel con- Janaanolitu-ah S45 


dition exists. haggt- 


/ @s The statement must not start with //. 
ep: “Ee The statement can start in any column. 
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RP as: 
en ® 
a4 (True/False) The size of $JOBCTLN is 1808 decimal bytes (Refer 
to the PARTIAL DSERV Figure in DOS/VS SCM 2). 


x 
4. (True/False) The first eight (8) bytes in a Job Control phase ven 
that has been loaded into the overlay area of $JOBCTLA will OBCTLA 
ed 


contain the name of the overlay phase. 
pme - 


(True/False) The Generic Assignment capability of I/O devices by 
job control must be included in a DOS/VS system by the user at 
* system generation time (SYSGEN). 


6. The following job control statement is an example of which kind 
of generic device assignment? 


// ASSGN SYSOOS, (X'183',X'184') 


sae Address 
_.._—-~iDe Generic CLASS 
Ce Generic TYPE , 


d. Address-list 


Refer to the Contents for the location of the self-evaluation 
question answers. 
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POWER GENERATION 


The POWER component is part of the SCP and therefore a PSR re- 
sponsibility to install. The concepts of POWER were covered 
previously. The parameters required to generate POWER will be 
discussed and the supervisor parameters required for POWER will 
also be discussed. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Given a customer prepared POWER source deck, install the 
POWER component. | 

2 State the function of any POWER parameter. 

3. Given a set of POWER generation parameters, determine the 
size of the POWER program that will be generated. 

4. Determine from the POWER assembly listing the minimum and 
maximum partition sizes required to operate POWER. 


Highlights 
} @ The DIAG parameter of the POWER macro causes a PSR service- 
7 ability aid to be generated in the POWER program. 
e Installation and verification of the POWER component is a 
PSR responsibility. 
e The execution time portion of the POWER program must be 
linkedited in from the relocatable library. 
e POWER program runs in real mode. 


e Check the POWER assembly and linkedit map for error diagnos- 
tics when installing the SCP. 

e When POWER is assembled, use multipart forms for the output 
listing. 

e Check the POWER macro parameters before assembling the POWER 
program. 

e Advise the customer on the benefits of including the DIAG 
parameter when selecting the POWER options. 

e Catalog the POWER object deck in the relocatable library So 


that replace (REP) cards can be used for fixes. 
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Activity 


DOS/SVS System Generation SRL | 


IN: 
READ: MODULE 2: GENERATING A VERSION OF POWER - 5745-SC-PWR 
through 
Deleting POWER Phases and Macros 
IN: DOS/VS System Generating SRL 
UNDER: 3 Chapter 1: Understanding the System 
READ: POWER 
through end of chapter 
UNDER: Chapter 3: Planning the Systen 
READ: POWER 
READ: Generating a Version of POWER 
UNDER: Chapter 8: Using POWER 
READ: Initiating POWER 


through end of chapter 


SELF-EVALUATION QUESTIONS 


1. 


2 
3. 


The purpose of the DIAG=parameter is to generate a POWER routine 


to ° 


BEED ee ADD GALE SES HOS SLED ED ED CP CEPA GE GSES RE CEN AED 


The entry point in the POWER program FGPSPOOL is ° 


When the POWER parameter TAPE=YES is specified, bytes will 
be generated in the POWER program to support the function. 


The label _—s——<Ctéi(“CCCCTI'ttAiN'S «GCtthe©6«6©CValue) 6 indicating the minimum 


number of bytes that must be allocated to operate POWER with all 
functions. | 


The core image phase name of the POWER program is 
unless the customer supplies his own. 


List the operands of the DELETR maintenance program control 
statement to delete all POWER components from the relocatable 
library. 


ER ED CES ED SEI LES CES ELIS ILD ETE 
TCD TEAL TEA A CED SS ERED SLED OS 


SE EE PEED EE aR GEDMhen 


Refer to the Contents for the location of the self-evaluation question 
answers. | 
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UTILITY PROGRAMS 


There are several utility programs supplied on the PID tape. These 
programs are of special value during SCP installation. This topic 
will discuss the different types of utilities and their use. 


This topic will present the utilities as three groups. 
1% DASD and Tape Utilites 


2. DEBLOCK Utility 
3. FASTCOPY Utility 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: _ 


1. Select the correct DOS/VS utility for any given job requirement. 
20 Select and deblock any given PTF. 
ise Use FASTCOPY to copy and restore a DOS/VS systen. 


Activity 

IN: DOS/VS System Utilites SRL 

UNDER: Introduction 7 

READ: Description and Characteristics 

REVIEW: Machine Requirements through end of Introduction 
UNDER: Deblock 

REVIEW: Entire Section 

UNDER: Fast Copy Disk Volume 

REVIEW: Entire Section 


SELF-EVALUATION QUESTIONS 


13 To run the Clear Disk utility, the program name in the 
// EXEC card is 


TREAT LIE 


SRT ETD SATE ELEY EY TELS I LEE AT ES CY ATT ELD I EELS LEIP TLLD EPL SNE AG SLND AA ETP 


> 


2. To assign an alternate track on disk, the symbolic unit 
required for the disk is 


= e 
RAILS EID SEDATE EM AIG PETE: AGED CRESS RGA LLNES PTE ARI BEND CME CELE TELE ALTE ELEN LAL EEL ALE LOCEL TELE ALO LEENA 


3. In the standalone FASTCOPY, the Utility Modifier Statement 
must be placed ° 


LE ETD IS SIRS SE TLEEY TD LE CED SI AT ATED CPE LIE LOTTIE EES ASD a TE LTD OTS LED LITE AIS 
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Gu. (True /False) 
card to tape, 


5. The VTOC on a disk may be printed by using the 
program ss etre ele 


The end of data cards, when blocking from 
is indicated by /*. 


Refer to the Contents for the location of the self-evaluation 


question answers. 
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This topic will introduce the Supervisor with emphasis on the 


major 
locat 
visor 


routines within it, their functions, and techniques for 
ing each of them. The macros used to assemble a super- 
and the assembly/catalog sequence will be introduced. 


This topic will lay the foundation for all of the following 
supervisor topics. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 


docum 


uw 
e. 
3. 


oe 

/ 
e Vv 
wee 


entation, should be able to: 


Locate and identify the major components of the resident 
Supervisor in a storage print. 

Locate, in a supervisor listing or storage print, the entry 

point in the routine that processes each of the supervisor 
interrupts. | 

Determine when any given error is caused by the lack of 

the correct macro coding at supervisor assembly. 

Use the supervisor listing to determine the size and initial 
values for the following tables: | 

= SYSCOM 

= COMREG 

= Boundary Box 

- DPD Table 

Locate the Supervisor routine that develops the low core messages 
and cancel codes and all linkages to this routine. 

Use the translation tables in the supervisor to determine if a 
page is in real storage and its location. 


DRALTAR. 


Highlights 


The system communications region (SYSCOM) contains information 
relative to tables and routines in the Supervisor. 

The partition COMREG contains general information about tables in 
the Supervisor and partition dependent information. 

Bytes 14-17 contain the address of the partition COMREG that is 
active. | 

The Boundary Box will contain the sizes of real and virtual 
partitions. 

The DPDTAB contains information relative to SYSVIS. 


4 ly 


Q Tt 
te @ f ers 


Inve J... 
» 


oe Je nates tah 
B= poteal - 
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ie EE qreo~esnpawra esnootin 


@ The contents of SYSCOM and the COMREGs are useful when trying to 
locate tables in the Supervisor. 

@ The BG COMREG PIK value indicates the partition enabled for 
interrupts or last interrupted (in control of system). 

e Always check the PSWs in the partition save areas to determine 
where program lost control in each partition. 

@ When the customer generates Supervisor(s) for the system, ensure 
that multi-part paper is used since a supervisor listing may have 
to be submitted with an APAR. 

® The labels in the cancel routines (ERRnn) are useful to trigger 
the SDAID program. 

@ Register 11 will contain the wait code on a hard wait. 

@ Always do a store status before taking a standalone dump. 

e Check the contents of the old and current PSW. 

Activity 

IN: DOS/VS Supervisor Logic 

READ: 4 Introduction 

through 
| Low Real Storage 
STUDY: ree. D: Cancel Codes and Messages 


ee 'System Communications Region Sar vai "ad & 
Figure 'Partition Communication Region! Wp he 


: boss ; Seto 
“Figure "Boundary Box (BBOX) * 


_Figure "Page Data Set Table (DPDTAB)'° rte 


SELF-EVALUATION QUESTIONS 


In a four partition system, the. partition in control of the 


system when PIK's X'30 is __ — ee eee 
The address of SYSCOM is located in storage at X'! Bs, 
The Supervisor parame hat determines the size of the PUB 


table is — A 2 Sha Batata le a et, 1 THe 


A code of 4 in PRR GN 3 of the DPD table indicates SYSVIS is 


eee) eee i pl? Hao Haan 
(True/False) A low storage message of X'QOOOOFFA' } will be : 
created if a Supervisor routine kFranches to label HARDWTPFA. ble De. 


The address of the end of real storage is located in SYSCOM at a 


displacement of X!_ Cs 
ENRSAr- 
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ag! brs. 
7. The byte and bit in the COMREG that indicates a // OPTION CATAL 
statement is in effect for a partition is __ . 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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ee a a Ns A eR A I 


LD ETRE ALPE ED CE AEETID AES AC RSL RIT CS A SEE 


When the currently operating program gives up control because of a 
Supervisor interruption, the supervisor must determine which task 
(program) is to get control of the system after the interruption is 
handled. 


This topic, will show how DOS/VS controls the system activity. Much of 
the discussion will center on the "dispatcher" or "task selection". 
Due to the possibility of program checks occurring in the supervisor 
(page faults) there are partition save areas in the supervisor. There 
are now a possibility of five system tasks and fifteen user tasks. 
This topic will discuss the areas in regard to the dispatcher and how 
these areas can be used to determine the status of the system and its 
resources. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


Ts Identify the purpose, locate ina storage print, and use the 
following items to determine the status of the DOS/VS system and 
its resources. no. , 


RID Otten | wt pet. 
STID/SELECT smoléen, Haske i 


PIK/TIK youtitu~ id. YE> il lan UF, 
LTK/LIK nk Hoh ieep, Due ics YUE. 
MVCFLD 4 

TRIMASK ¢ 

TRIFLD » hh 

TRFLD ' 

System Task Control Block 4G. 

PIB Table 


PIB Table Extenstion FILA $3 

System Save Area (Special Save Area) J 

System Task Save Area 

Dispatcher routine 
ae Identify the function of the SVC22 and SVC33. 
35 Identify the following terms in relation to DOS/VS: 

Disabled/Enabled state 

Gated routine 

Reentrant routine 

Reusable routine 
u. Determine from the translate and test mask (TRIMSK) when the 
logical transient area is busy, and when the system has been 
seized by any program. 
Use the program interrupt key (PIK) to determine which partition 
is or was in control (enabled for interrupts), at any given point 
in time. 
Use the logical transient key (ITK) to determine which partition 
is_using the logical transient area. 


LIK U- ROCOMKE, = PDK AB one, LA 
Op Lr fee. 
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STIO 


Highlights 


® Partition general registers and the partition's current PSW are 
saved in the partition savearea upon entry to the supervisor. 
e The five supervisor tasks in their priority are as follows: 
= RAS (optional) 
- Page Manager 
- Supervisor (Fetch routine) 
= CRT (optional) 
= ERP 
© Program Interrupt Key (PIK)/Task Interrupt Key (TIK) in the BG 
communication region identifies the problem program task in 
control of the systen. 
® The label of the dispatcher in the supervisor listing is “EXIT". 
@ The STID (SELECT byte) identifies the supervisor task active in 
the systen. 
* e a 
Troubleshooting Hints f within. 
e Check PIK/TIK to determine a haves task in control of the system 
if the system enters a wait state. 
€ Check STID to determine the supervisor task active in the systen. 
@ Check low core for a message 1f e system enters the wait state. 
6 The fields "TRTFLD" and "TRFLD" in the supervisor can be checked 
to determine the status of all _ tasks the last time the dispatcher 
selected a task to run. 
® The reason a problem program task loses control can be determined 
from the interrupt information in the PIB extension and the PSW 
in the partition savearea. 
® The DAT flag in the PIB indicates the state of the partition in 
regard to supervisor routines and if the artition special 
vearea in the supervisor is active. 
@ If the system enters the wait state, check the ‘'TRITMASK' field 


4 
of 
Y 


for the status of s sten resources. 
LTK : Wii puitytun daring ITA jw hake. 
Inn TOOK i Biba ix prot \ LZfr bmn. . 
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Ne DOS/VS Supervisor Logic PLM 
EAD: +4 'Task Selection’ 
1 through 
83 "Asynchronous Processing'® 


STUDY: Figure for 'Program Information Block (PIB) Table’ 
Figure for ‘Indications of Logical Transient Area 
Occupancy and Activity' 
Figure for 'Program Information Block Table 
Extension! 


IN: | DOS/VS BASE SCM 1 
REVIEW: oe TASK SELECTION SECTION 


SELF-EVALUATION QUESTIONS 


1. (True/False) When a page fault occurs ina reentrant supervisor 
) routine, the routine cannot be entered again until the page fault 
- has been handled. 


2 A disabled user task is operating with I/0 and external 
interrupts masked (on/off) in the PSW. 


3% The field can be used to determine the status of the 


4. The name of the routine that restores the PSW and registers for 
a reentrant supervisor routine after a page fault was handled is 


SD AD a CED CAT Aaa NTE EE ER EP GEE AEP RE GRP ED CTE cD GS OP A EE Oe eT a 


5. If a system task wants to give a higher priority ready system 
task a chance to run, it would issue a _@WC3i._. 

6. The number of the last $VC.issued in a partition could be 
determined by checking AVON AM. setae tat, fe 

1% In a core dump, where can the cancel code for a problem program 


be found? 


RA. 


8. How does the supervisor transfer to the Attention Task Handling 
POUTIMES 2 a Be ee se et 

o% In a core dump, where can the address of the Ft save area be 
found? 


ING CRY SOAR MONEE REN ERE DPM CIS ROG ERAS RN AE: CORRES SOON SIRNA CATON RRR EMIS a ERA EE EM. Goo GORE GG CZs GER RORAEY EMO CURES ERO kG co SITET GREE SMEREESRIMO: SUE CIEE RERR ONE Ona GEST GEERNO cEER/ MEER GEN vel come 


10. Where are the partition communications region's addresses stored? 


SED EU ED ETD CED EE A ES CS SS ED ES AD OS EE ES OAR AY CE CT A TD GP AOR SRO CRD REED SOND CERTARE QUERCUS SERRATE CD RD ED EEN SE 
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11. What does it mean when a byte of the ‘TRIMASK' is changed to 


e ‘? 


12. The 'PIK* is found at byte displacement into 


partition 'COMREG'. Its value for problem programs is equal to 
the hex value of the program's storage protect key multiplied by 


‘ e 
CARED A ES CDT CLS CAD GORD TREDIS ETC SES AED GP CEP TS ESD CU 


13. What does a 'LTK' value of X¥'20' indicate? 


AAD AED CEP EES AD PE ES EDD AR ES OED LOTS TED gAUEIO OTE LED LILES eT AANA DY OEE IP IS LEE GELR GS CL 


EE IE SEIT 


14. Where is the 'LTK! located? 


Ce CREED CMY aes “EEE cee cunt SED AED GERD aD CES EES GED NYS CD cI nae OS ean ESE OED ES aD ce 


Refer to the Contents for the location of the self-evaluation question 


answers. 
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Problem programs request I/0 operations by using the EXCP, WAIT, and 
CCB macros. The issuing of the SIO and the handling of the subsequent 
I/O interrupts are accomplished by two major routines within the 
supervisor which are called the channel scheduler and the I/0 
interrupt handling routine. 


This topic will teach the student how to use the program logic manual 
(PLM) and the supervisor listing to analyze and correct or circumvent 
problems in these routines. 


The ‘'CCW Translation routine used for I/O requests from a virtual 
partition will be covered ina later topic. 


OBJECTIVE 


Upon completion of this topic, the. Student, using the available 
documentation, should be able to: 


‘Ag Locate the channel scheduler start I/0 instruction and all 
instructions that modify it in core when given a supervisor 
listing. | 

2 Locate the PUB table and channel queue and use them to determine 


which devices have TI/0O requests from the problem program when 
given a supervisor core dump. | 


Be Locate in a core dump, all communications regions, LUB, PUB, 


channel queue, and channel scheduler routines, and list the 
sequence of their use for two consecutive I/O requests to a 2540 
reader. 
u. Use the I/O trace to determine the number and sequence of all I/0 
events, and to locate the CCB for each request. 
5. Use a core dump of the physical unit block (PUB table) to 
determine the following. | | 
The number of entries into the device error routines 
({non-T/P) for each device 
The device type for each entry 
The TEB table entry if that option applies 
If a device is on queue and busy 
If a device is switchable 
6. Determine the standard and temporary assignments for all systen 
and program LUBS (symbolic assignments) by using the LISTIO 
command and by analysis of the LUB and JIB tables in core. 


Te Use the register ID to determine the partition using each entry 
in the channel sequence. 

8. Locate and interpret the following tables as an aid to. problem 

| determination: 


Pub Owner 
Channel Buckets 
Channel Control Table 
| Headqueue PUB Table | 
os State in ycur own words the purpose of any SVC related channel 
scheduler services. 
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Highlights 


® The DOS/VS Supervisor handles all I/O operations. 

e I/O is initiated via SVC interrupt. 

& I/O is terminated via I/O interrupts. 

e The PUB table contains an entry for each physical device on the 


system. 
e The PUBOWNER table identifies the partition owning each PUB. 
® The LUB table contains a pointer to the assigned physical unit. 
e The JIB table holds standard assignments for temporary LUB 
assignments. 
® The channel queue is used to store the CCB address from an I/0 


request (SVCQ). 


@ Register 1 usually contains the address of the last CCB used. 
The channel buckets (label REGSAV) will contain information about 
the last I/O on a channel. 


e The ADD/DEL statements can be used to alter the content of the 
PUB table at IPL. 
@ The PUB Channel Queue Pointer can be used to determine the I/0 


requests for a device, if any. 


@ The PDAID I/O Trace can be used to obtain a list of all MI/0 
Interrupts or stored CSWs. 
Activity 


IN: GINQEKY DOS/VS Supervisor Logic 
Re Physical I/O Control Systen 
READ: (29-139 To CHANQ figure 


STUDY: The following tables 
CHANQ 
PUBTAB 
PUBOWNER 
JIBTAB 
CHNTAB 
ty LUBTAB 
Channel Buckets 


READ: [38 "Selector and Block Multiplex Channel Switching! 
ue through 
‘Command Control Block' 


STUDY: Ite CCB Table 
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SELF-EVALUATION QUESTIONS 


1. Which of the following items would be most helpful in locating 
instructions that modify the channel scheduler start fI/0 


instruction? 

Ae Supervisor PUM 

be Cross-reference listing of the supervisor 

cy Microfiche copies of the error transient routines 


2e What byte(s) in a PUB table entry indicate(s) that an I/O request 
has been queued for that device? 


ae Byte zero 
b. Byte six, bit 3 
Ce Byte seven, bit 5 


d. Byte two 


3. How does the LUBID entry relate to the channel queue? 


ae Pointer to the logical unit translate table identifi- 
cation 

b. It points to the CCB of the program requesting I/0 

c. It points to the next entry in the channel queue 


d. It points to the logical unit that requested I/0 


4 Given the following PUB entry in hex, fill in the blanks: 


X¥*0283030050C3c0C4! | @ 
ae The channel address is _ ease Be oes es 
b. The device address is __ eee ao, ae 
Cx The device type is __ Siew pe, 
d. The device (is/is not) busy. 
e. The device (is/fis not) on queue. 
Es (True/False) A TEB table entry is associated with this 
device. 
qd. This device __——— tC‘ SS NOL) Switchable. 
h. The device is _ (a 7-track tape/a 9-track 


tape/not a tape) unit. 


Ss What one LISTIO command will print all the devices in the PUB 
table with their associated assignments? 


EP SS CRS IDE RATED 


CRT eee 


2 4 
6. To determine the last I/O successfully started on a channel, the 
_ table could be interpreted. 


AS LE AP ETD 


Ts A "REQID' of xX'30" indicates that the partition using the 
associated CCB is the __ _. partition. 


SP TD ED AY NTE eS OUTS ET EY SO 


8. In a core dump, a LUB value of X'FEFF' indicates an assignment of 


AE, TD ED TTD CE PRS ED ET EPS A ATG AED OTS I TS a 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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Device Error Routines in DOS are core resident for the disk devices 
(SYSRES), and are fetched from the core image library for non-SYSRES 
device types. 


This topic will teach the student how to use the fetch trace routine, 
PLMs, and microfiche listings to determine the system operation when 
a device error occurs. 


OBJECTIVE 

{ 
Upon completion of this topic, the student, using the available 
documentation, should be able to: 


A Determine the phase or routine that issued any physical I/0 error 
message (OP08 through OP60) and indicate what sense or status 
checking took place prior to the message being issued. 


Lis Determine the phases(s) that are used for error recovery and 
error recording (non-T/P devices only) from any given device 
type. 

oe Determine what I/0 devices had been entered into the error queue 


when the error queue overflow message is issued. 
4. Locate the sense data device address, SEREP interface code, and 
message for low core I/O error messages, with the system in the 
wait state: then determine if it is a hardware or program 
failure. 
56 Given a storage print obtained due to an error in ERP, locate and 
interpret the following: | 


- ERBLOC 

- A-transient area 
- PUB2 Table 

~ RF Table 


- Unit Check Record (In core or from SYSREC) 
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Highlights 


Device error recovery is performed on DOS with A-transients. 

When device error recovery is entered and the error can't he 
corrected, all status is logged on the console and the operator 
is given an option (RETRY, IGNORE, CANCEL). 

On unrecoverable errors that cannot be retried, the SEREP 
interface will be set up. | | 
Disk error recovery is resident within the Supervisor for DOS. 
The Error Queue entry is built by the I/70 interrupt handler 
routine of the Supervisor. 

The five functions required for ERP are: 

~ Supervisor Resident Routine 


= -RMSR Recorder Transients (update statistics) 
= Error Recovery Procedures 


= RMSR Recorder Transients (write unit check record) 
~ ERP Message Writer Transients | 
SVC 5 is used to fetch A-transients 

Svc 44 is used to write the unit check record on SYSREC. 


Troubleshooting Hints 


Observe the information in the error queue when an I/O error 
occurs. | 

To prevent information from being reset on an error queue 
overflow, SAR stop on ‘'ERR31"' in Supervisor take a standalone 
storage print. | | 

The PUB Table contains the number of retries attempted and a flag 
that indicates if the device is queued for error recovery. 

The section in the PLM on I/O recovery procedures and sense data 
can be used to determine what DOS did to recover from the error. 
The PDAID Transient dump can be used to obtain a storage print of 
an A-transient causing a program check. 

The DOS/VS Error Recovery and Recording Transient PLM contains a 
description of ERP action and a message cross-reference for the 
ERP transient phases. 

Use the PDAID I/O Trace if a problem is suspected with I/0. 


IN? DOS/SVS SCM 1 
READ: p16 ‘Invocation of Error Recovery Procedures! 
IN: LINER hy DOS/VS Recovery and Error Recording Logic 
READS: Chapter 1: INTRODUCTION 
Chapter 2: DEVICE-DEPENDENT ERROR RECOVERY 
PROCEDURES 
Chapter 4: RECOVERY MANAGEMENT SUPPORT RECORDER 
(RMSR) 
through | 
"RMSR Functional Flow for Unit Check Type Errors 
on Data Cell, Tape, and Unit Record Devices! 
IN: Binter 9 DOS/VS Supervisor Logic 
UNDER: Physical Input/Output Control System (PIOCS) 


1ZI—-18S 'krror Queueing and Debe¢geire'! QuawrOy 
through 


'3330 Disk Storage Error Recovery! 


SELF-EVALUATION QUESTIONS 


1. 


Zs 


What bytes in an error queue entry contain a pointer to _ the 
device address for devices on queue? Nit _-* 


Assume the following message was issued while attempting to list 


on a 1403 printer: | ee 
(eS Pheer! 
BG OP10A EQUIP CHK SYSLST = OOE © | 
CCSW= 0B10022B5006000000 SNS4010000000000 CCB=022AD8 


a 


The name of the ERP phase (not RMS) that will handle this error 


BD ae ee edit eae (h Ye. LEAR CRB! 


Using the example in question 2, fill in the blanks below. 


ae Device Address (YE 
b. Partition issuing the message SS ee eet ge ee eee oes: 
Ci CCW command code De te ds a tl ete 
d. Status indicated | a 
e. CCB location 

te CCW location Geen) 
qd. Sense information indicated $4 SLU aD Se 
h. Storage protect key =: 5 | 


Given a device type of x'50', what is the first transient called 
in the event of an error? Use Chart 07 in PLM. 


Panty $A PEERB 


EES AD cE EE EES ED NE ONCE ES NT ES SS SE GE CED SD CED GEARY GED CSSD GED SENS GETEY CEE GEES QUE CREE CEECEED EA CTE AEDES STE SEED ALD ATO CED SEED EES OY MND MP ORTAT ND 


10. 


State the purpose of the PUB2 entries. 


Given a core dump, how would you locate the first error queue 
entry? _ | 


ED CED EPS ND 


A ES AR RT ED CRED REE RD ETDS AD A ED ED ND AD AD ADD AY AP NY NS LY LT LD 


A GEN EE EE ED EE CE EE EE EE CCR: CEE CE EE RN ED ETE TED SEE GENE ED COD EE SD EP A A SAS NP , AAS A A A AD 


TP AS CS SA Sa 


ne Peep ene TAD LN TS TS TS a TP 


The system goes into the wait state. Where can a method for 
determining the cause of this error be found? 


A ALS TL CTS AP LGD LD ST ORES LOY EY TE LD SOD beeen 


A. CS A A A LTTE TD POA 


Given a message 'OP34', name the transient that detected the 
error and caused the message to be issued. 


a cee aD ee ne Cn Cn in ee GD ae ae 


The sense byte information for a 1403 is located at displacement 
of Xx! _' in a Unit Check Record. 


The ‘intervention required' statistical counter is located at a 


displacement of X*_ " in a Unit Check or Counter Overflow 
Record for a 1403. | 


pee Ge ene eee ee ee ene ee eee eee 
SD CE NID ED ES A ND ED EP EES SED CS SUED LS GN TS A TD NY AD A IS AD SS SS AE A AS A AS A A A AS a A A AS AS a a ND AEP ED a NNT OD ON SS ED SD SS PAD 


EN AD OD ED AES EY ES GEES LATE LY NY A A OP ATE A NS NS OS AD TS aS A A AS TS TS AS AS TR eS aD a TS aS ca! 


Refer to the Contents for the location of the self-evaluation question 
answers. | 


MACHINE CHECK AND CHANNEL CHECK HANDLING (MCAR/CCH) 


With the growth of more and more online data processing activities, 
increased reliability, availability, and serviceability (RAS) of 
computing systems have become a prime requirement. Improved hardware 
features have been included in System/370 to accomplish these goals. 
The programming systems used with System/370 have also been expanded 
to provide increased recovery support in the event of system failures. 
In this topic we will study the functions and overall program logic of 
recovery management support (Machine Check Analysis and Recording 
(MCAR) and Channel Check Handler (CCH). | 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should he able to: | 


1. Locate and interpret the following areas in a storage print as an 
aid to problem determination: 
RAS Monitor Table (RASTAB) 
RAS Linkage Area (RASLINK) 
Error Recovery Procedure Information Block (ERPIB) 
Limited Channel Logout 
| RAS Transient Area 
2 Use tables in PLM to determine how the channel check severity is 
determined and recovery action. 
3. State the function of any RAS Transient. 
We Determine the routine/phase that issues any RAS message or low 
core message. | 


Highlights 
® The CCH routine attempts to recover for channel control checks 
and interface control checks. 
® DOS/VS will attempt to record hard and soft machine checks 
(dependent on EFL). ; 
® The three elements of MCAR are: 


- Resident Machine Check Handler 
= RAS Monitor 
- RAS Transients 
@ The four elements of CCH are: 
- Resident Channel Check Handler 
- Resident DASD Channel Check Handler 
— RAS Monitor 
- RAS Transients 
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Activity 


IN: DOS/VS Error Recovery and Recording Transients PLM 
READ: Chapter 3: MACHINF CHECK AND CHANNEL CHECK 
: HANDLING (MCAR/CCH) 


STUDY: Figures of Machine Check and Channel Check Record 
Format on IJSYSRC 


SELF-EVALUATION QUESTIONS 


There are no self-evaluation questions for this topic because the 
objectives are addressed by questions on the MCAR and CCH Work 
Project. 


SUPERVISOR TASK (FETCH) CONCEPTS AND TABLES 


After a program has been cataloged into the core image library or 


PCIL, 


it can be retrieved and brought into storage by any problem 


program through the use of the fetch or load macro (or the equivalent 
coding), which issues a SVC and gives control to the supervisor task. 


There are ten SVCS used for fetch and passing control. This topic 
will teach the tables used and the concepts of the fetch task. 


OBJECTIVE 


Upon 


completion of this topic, the student, using the available 


documentation, should be able to: 


1. State the objectives or a Fetch or Load. 

2e Correct any given coding errors ina Fetch or Load macro. 

3. Identify the contents of any given field or table used for Fetch 
or Load, given a disk dump or storage print. 

4. Use the Fetch Ene es to stop the system with any desired phase 
in storage. 

5. Use the PDAID F/L Trace to determine the sequence of accessing 
phases within ao given progran. : 

Highlights 

© The system loader is resident in the supervisor and loads 
programs from the core image library into storage. 

6 The FETCH and LOAD macro can be issued by the problem programmer 
to cause a program phase to be loaded into storage. 

® The SVC 2 will cause a logical transient to be fetched. 

® 


The SVC 5 will cause a physical transient to be fetched. 


Use the CE Serviceability Aid Fetch/Trace | 

$$A and $$B phases can be loaded into core by submitting a 
// EXEC phasename card and the phase will be loaded into core 
after the i a aaa Usually a Program Check and dump will then 
OccuUr. 
When a logical transient is cancelled, the system will call in a 
logical transient to dump storage and overlay the transient and 
the logical transient register save area. If it is necessary to 
know the contents of the LTA and LTA register save area, you must 
stop the system prior to fetching the first termination phase 
(SAR stop on mahchine check old PSW) and take a standalone dump 
or use the PDAID of Logical Transient. | 


Activity & 


IN: DOS/VS Supervisor Logic 
READ: svc 1 
svc 2 
svc 4 
svc 5 
SVC 8 
svc 9 
svc 11 
SVC 23 
Section on Program Retrieval 
IN: DOS/VS Supervisor and I/O Macros 
READ: FETCH Macro 
LOAD Macro 
GENL Macro 
IN: | DOS/VS Base SCM 1 
STUDY: FETCH figures 


SELF-EVALUATION QUESTIONS 


1. Which of the following should issue a SVC 11? 


ae Problem program (any partition) | , 
b. Logical transients @ 
Ce Physical transient 
d. Supervisor fetch routine 
De If you suspect the reason a multiphase program aborted is because 


a portion of it was overlayed, what PDAID would help in 
determining the last phase fetched before the cancellation? 


3% Which of the following SVCs are used to return from ae problen 
program to a logical transient? 


Ae SVC 2 
b. SVC 8 
Cs SVC 1 
d. svc 9 


4. The high core address of the last problem phase fetched is 
available in: 


ae The COMREG displacement 36-39. 

De Register 2. 

oe The COMREG displacement 40-43. 

d. Bytes 4 through 6 of the associated PIB. 


5. The address of 


Ae SYSCOM. 


b. the System Directory. 
Ce the Fetch Table. 
d. General Register 14. 


the F1 PSLD can be found in: 


6. The length of an 'in-core? directory entry is: 


a. 30 bytes. 
b. 34 bytes. 
Ce variable. 


d. 42 bytes. 


7. A LOAD macro with TXT=NO, 


a. Search the SCID first. 
b. Use the directory element if active. 


Ce Fill in th 


d. All of the above. 


SYS=YES and DE=YES will: 


e directory element if inactive. 


8. Put the following SVCS in the correct sequence for a 
program that requires a logical transient routine. 


ae Svc 
b. svc 
Ce SVC 
d. SVC 


1 


9 
2 
1 
8 


———— 
emma 


Refer to the contents for the location of the self-evaluation 


answers. 


problem 


question 


SUPERVISOR TASK (FETCH) OPERATION 
The internal operation of the Fetch routine will be shown. This will 
be accomplished by using an example of a fetch of a_ relocatable 
problem program phase. , 


The areas used by the Fetch routine to build CCWs, relocate address 
constants, and store intermediate information will be shown because it 
can be useful when working on a problem in this area. The activation 
and deactivation of the Fetch task by other routines will also be 
discussed. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Given a message, loop, or wait state due to a fetch routine 
failure, locate the failing instruction in the Supervisor. 

2. Locate and interrupt the contents of the SSA and TCB, used by the 
Fetch routine, as an aid to problem determination. 


36 For any given fetch, determine the sequence the directories are 
searched. 

Highlights 

@ Fetch is performed by the Supervisor System Task. 

® The directory search depends on the parameters selected in the 
macro. 

® Phases may be fetched from a Catalog or Link Library. 

e Directories may be : 
- Within the macro expansion (DE) 
- In a list in storage (GENL) 
- On disk 


The Supervisor may be ‘shut down! by the Load Leveler. 
The Supervisor task (Fetch) has its own CCW translation routines. 
Fetch uses CTFIX. 


Troubleshooting Hints 


e Use the Fetch Table to determine directory status. 
e If Select is 03: | 
- Check Fetch SSA and if 
SYSFLAG 3 has bit 7 = 1, the TCB information will 
be in FCHWORK and FCHWORK1. | 
SYSFLAG 3 has the bit 7 = 0, the TCB information 
will be in the issuing partition's TCB, 
e If SELECT is not 03 and Fetch failure is suspected: 
- Scan PIB tables for an 01 in the fifth byte. 
- Check partition SSA for PSW pointing to SETFCH 
routine. | 
- If PSW contains this data, TCB has valid infornm- 
| ation about the interrupted fetch. 
- Use SCM to determine values in TCB. 
Activity 
IN:  DOS/VS BASE SCM 1 


STUDY: Fetch section 


SELF-EVALUATION QUESTIONS 


There are no self-evaluation questions for this topic. All objectives 
will be met via Work Projects and T/As. 


| 119 


SHARED VIRTUAL AREA (SVA) @ 
This topic will discuss the DOS/VS facility which allows relocatable 


and reentrant phases to reside in the SVA. Also included will be a 
discussion of the System GETVIS area. 


OBJECTIVE 


Upon completion of this topic, the student, using the documentation, 
should be able to: 


is State the advantages of using SVA cataloged phases. 
2. Determine the disk address of the SVA on SYSVIS. 


3. Determine the directory search sequence when using SVA. 

4. Identify the contents of any given table in a storage print. 
D6 Identify the macros and/or commands used for SVA support. 
Highlights 


® Often used phases may reside in the SVA. 

e SVA phases must be relocatable and reentrant. 

e SVA support is built at SYSGEN. Job Control statements are used 
to load the SVA or alter its size. 


@ The System GETVIS area has been added, “primarily © to support VSAM. 
Activity 
IW: DOS/VS Supervisor and I/O Macros , 
READ: GETVIS | | 
and 
FREEVIS 
IN: DOS/VS Supervisor Logic 
READ: Writeups for 
Svc 61 
SVC 62 
SVC 65 
VSTAB Macro (SVA parameter) 
IN: DOS/VS System Control Statements 
READ: SET (SVA and SDL) 
INS: DOS/VS BASE SCM : 


REVIEW: SVA Section 


SELF-EVALUATION QUESTIONS 


4. 


2- 


5. 


Refer to the Conten 
answers. 


(True/False) The SDL can only be created at IPL time. 


The advantages of having phases cataloged in the SVA are: 


ae 


i 
I 
TDD TED AEE EE A ES OS A I ND CE ND TD A TNS ETD IE TTD PED ED AR RR NS A ATE A ED DS CE LTD LY A OD 
| 
~. 


b. : 


i 


Ce 


| 


AS AEE OED AS AD AD SED ND AD AS AS TD AS A A OS AN TRAD E ND OS TT GIES 


Given a FETCH operation with the following oftions 
LINK 
PCIL ! 
LDL 
SDL 


the directories will be searched in what order? 


The statements required to create an SDL entry and load 
JACK into the SVA are: 


ae | 
b. nee 
Ce ! 


LL ALND TD A EN A EO, ADA SLED SIR NAD ACES CON 
i 


The phase card for JACK would have to be _ coded 
support this phase in the SVA. 
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ts for the location of the self-evaluation question 


DOS/VS_ TIMERS 


The measurement of elapsed time during user program operation requires 
an accurate method of measuring time intervals. This topic will 
discuss the Interval Timer and TOD Clock. The macros required and 
coding technique will be discussed. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to; 


1. State the use of the Time-of-Day Clock. 
26 State the use of the Interval Timer. 


3. Identify the macros used for TOD Clock and Interval Timer 
support. | 

4. State the use of any given TOD or IT macro. 

Highlights 

e The Time of Day Clock keeps track of time in hh/mm/ss. This 
clock is set at IPL time. | 

e The Interval Timer may be set by the user to measure time 
intervals. 

e When the IT Interval decrements to a zero, an interrupt is 
generated. Control is passed to a user routine at this time. 

e The ITREQ table is used for managing multiple partition timer 
requests. 

e The ITTAB is used to store linkage informaticn from a STXIT macro 


which is used at interrupt time. 


Activity 

IN: ~ DOS/VS Supervisor and 1/0 Macros 
UNDER: Supervisor Macros 

READ: Time-of-Day Macro 


Interval Timer and Exit Macro 
Entering a Routine when Time Elapses 
Entering a Routine at Given Intervals 
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roe System Management Guide 


IN: 
UNDER: Chapter 10: USING THE FACILITIES AND OPTIONS 
OF THE SUPERVISOR 
READ: | Timing Features 
to 
Checkpointing Facilities 
IN: pos/vs Base SCM 1 
STUDY: Eneste Timers Section 


SELF-EVALUATION QUESTIONS 


1. 


2 


7. 


The STXIT macro when issued with ONLY the first operand will 


; e 
| 


(True/False) The Interval Timer can be set for an interval of 24 
hours. : | 


The WAIT macro ssi ‘aw:C(éd(SS'SS NOt) Qenerally used in a routine 
with a STXIT. . 


To wait for the timer to reach zero before coneranang processing, 
the 1 should be used. | 
The macro SETIME 1800 will cause the timer to be set for an 
interval of : 


—— 


The GETIME Macro is used in conjunction with 


| 
i e 


| 


If TOD support was not specified as a SYSGEN option, 
| walt be returned on a GETIME. 7 


Cy RS RISD GETS Sea SEPA EAs CED SED GUESS SD 


Refer to the contents for the location cf the self-evaluation question 
answers. 
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This topic will review the concept of the page manager. Then the 
tables required for page management will be discussed showing their 
formats. This topic prepares the hbase for all the following page 
manager topics. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. State the objective of the Page Manager. 
2% Identify the routine(s) which initialize the system for DOS/VS. 
me Identify the contents of any given table used to support virtual 


operation. 

Activity 

IN: DOS/VS BASE SCM 1 

UNDER: "Page Manager' 

REVIEW: The following figures 
DOS/VS Control Flow Objectives 
Pre-IPL DOS/SVS System 
DOS/VS IPL Functions 
Function of EOJ Transient during IPL 
Loading of Job Control after IPL 
Loading a Virtual Problem Program 
Termination of a Virtual Partition 
Use of Translation Mode in DOS/VS 
Abbreviations 
Page Management Tables in Relation 
to Real and Virtual Storage 

IN: DOS/VS Supervisor Logic 

UNDER: 'Page Management! 

READ? Page Management 

! through 
Page Table Initialization 

IN: DOS/VS Supervisor Logic 

UNDER? ‘Page Management' 

STUDY: The layout of 


Page Frame Table 
Page Frame Table Extension 
Page Table 
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SELF-EVALUATION QUESTIONS 


A One page table is built for each segment of virtual storage and 
contains ___s:«CttWO byte entries. | 
ae 16 
b. 32 
Ce 48 - 
d. 20 | 


e. None of the above 


2. The initialization of the Page Table is done by routine 
during IPL. | 


ae INITPT 
b. JOBCTLA 
Cie EOJ | 
d. INITDAT 


3 (True/False) The Segment table is not used by the Page Manager. 


4. The Page Frame table is located at label _... _—in_ the 
Supervisor listing SCM. 
Ae PFT 
b. PT 
Ce PFRT 
d. PGFRT 


Refer to the Contents for the location of the self-evaluation question 
answers. | 
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PAGE MANAGER INITIALIZATION 


This topic will discuss the initialization of Page Manager Tables in 
DOS/VS. Initialization occurs at IPL time and by Job Control when 
loading a virtual progran. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Determine if IPL has initialized the Page Manager tables 
correctly. 

2 Determine if Job Control has initialized the Page Manager tables 
correctly. 

3. Identify any given error in IPL or Job Control Initialization. 


Highlights 

@ DAT is "Off" during part of IPL. 

e The Page Manager tables initially contain values from Supervisor 
assembly. 

e IPL initializes all PT entries above the Supervisor and_ sets 
storage protect keys. 

e The initialization routines are entered via SVC interrupts. 

e SYSVIS is readied for use during IPL. 


a op Gp epee ane a ane een emmeers ame oem 


@ If the PSW or Control Registers are incorrectly initialized, 
check INITDAT routine. 

® If the Page Table is incorrectly initialized, check INITPT 
routine. | | : 

e INITDAT routine initializes the B BOX. 

Activity 

IN: DOS/VS IPL and Job Control 

UNDER: Introduction 

READ: IPL and Job Control 

IN: DOS/VS Base SCM 1 

REVIEW: Page Manager Initialization Section 
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SELF-EVALUATION QUESTIONS 


1. After exectiting the INITDAT routine all page table 
entries above the End-of-Real Storage will contain 


| 


2. The INITDAT routine is called by _ _ : 
3. The INITPT routine is called by ° 
4, The INITDAT and INITPT routines are part of __. 


5. The INITPT Routine will set the F1V page table entries 
to —_——+ 6 


A SD aR 


6. After INITPT the PFT entries for areas above the 
Supervisor will contain ______ in bytes 4 and 5. 

Refer to the Contents for the location of the self-evaluation 

question answers. 
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PAGE MANAGER SERVICES 


The page manager provides its services to system and user tasks. Its 
primary function is to manage the real storage resource of the systen.. 
The concept and operation of the page manager for page faults, 
TFIX/TFREE, PFIX/PFREE, and GETREAL/FREEREAL will be shown. The page 
manager uses the page frame table, page table, FIXWTAB and PFIX table 
to manage the real storage operation. The manipulation of these 
tables and their contents will be discussed in some depth. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


As Locate any given error in the Page Manager. 
2 Identify the failing Page Manager Instruction when a failure 
occurs in: | 


- TFIX/TFREE 

~ PFIX/PFREE 

- GETREAL/FREEREAL 

~ Page Fault Handling 


3. Locate and interpret the contents of the following tables used by 
the Page Manager: 
- Segment Table 
= Page Table 
= Page Frame Table 
= Page Queue (PGQU) 
= _FIXWTAB 
= Storage Protect Key 


Highlights 


® DOS/VS Supervisor and problem programs (virtual and real) execute 
with DAT ‘On’. 

e The PGQU is the interface between the Supervisor and Page 
Manager. 7 | 

® The FIXWTAB is used by the Page Manager for posting of tasks when 

| resources are available. | 

@ The Page Manager will minimize page I/0 by exchanging pages, 
paging out only when data has been changed and paging in only 
when there is valid data on SYSVIS. 


® The NF bit being on in a a PFT entry indicates a request for the 
physical page frame (storage). 
® The NFF bit being on in a PFT entry indicates a request for a 


logical page. 
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| 
| 


Troubleshooting Hi ats 


e The Page Manager will normally post a task with a PIB flag of 
X'87* when it enqueues the request. 
@ The Pge Manager tables are formatted by the standalone dump. 
e Use SYSVIS dump to display virtual storage. 
® The storage protect keys can be displayed with a DK command on 
the console or standalone dump. 
@ If the systen penere a soft wait, check the PIB flags of all 
tasks. 
® Check low core X¥'90" to determine the last request enqueued to 
the Page Manager. 
® The PSW in the partition save area indicates where a program was 
interrupted. If the partition was interrupted by a page fault, 
the PSW points to the first byte of the instruction causing the 
interrupt. | | 
@ In a eo. cater storage print, the formatted low core information 
is valid and the low core information has been overlaid. 
6 Use SDAIDS to monitor paging activity. 
Activity 
IN: DOS/VS Supervisor Logic 
READ: Page Management 
through 
PREEREAL, TFREE, and PFREF Requests 
UNDER: Supervisor Call Interrupt (SVC) 
READ: Svc 54 
sve 55 
SVC 58 
sve 59 
‘svc 61 
SVC 62 
SVC 66 
Svc 67 


SVC 68. 


SELF-EVALUATION QUESTIONS 


1. 


Du 


3. 


4. 


The ENQU routine in Page Manager builds PGQU entries in low 
storage location Pe ee 

The system task requesting a given PGQU entry can be identified 
by examining of the PGQU entry. : 


AF IN AE ERNE AOS RI NE ET SEATON 
| 


Bit 14=1 in a Page’ Frame table entry indicates 


SD NS EE Ee OE ED NS ED EE SED FE ED NE EE ED ED ED AUD ND ET ED ED ED GES SEED EEN SD SETAE CNS AS ES 


(True/False) A PFT entry with NFF bit=1 indicates that there is 
a pending request for the page frame. 
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5. The Page Manager uses the table PCKATAB to determine 


e 
SAPD GTP STORED CLIT ANTE CETTE LED CRG GLP LD AETID CE IS 


A A A A a A ES ATT ES 


EP ED MED ED RES EP RP TC EP OEY 


6. A task waiting for a page will have its task identification 
posted in | _. of the associated Page Table 


entry. | 


Te If the System Save Area is indicated as active by the PIBDAT and 
the PSW points to the label LOADRA2, the Page Manager is doing a 
and waiting for a % 


SPE AILS LGD SPE IEE LLG LITO EES A AE TG AR A TS AE CEE EP PP A ieee 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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PAGE REPLACEMENT ALGORITHM 


This topic will discuss the algorithm used in DOS/VS to determine 
which page is to be replaced on a page fault. The algorithm attempts 
to select the least recently used (LRU) page. Also included is an 
explanation of the Load Leveler and the Dynamic Reallocation of 
Partitions (DRAP). The Load Leveler is a portion of the Page Manager 
that monitors the amount of paging activity. If the activity becomes 
too high, it will then attempt to deactivate a partition. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


Use the following areas in a storage print to determine how a 
system has been reallocated after an error in a page frame: 
SYSCOM | 


1. 


PFT | 

Partition COMREG 
Given a system wait, due to an error in the Load Leveler, 
the problem using the following: 

RTAB 

A CONST 

B CONST | 
Given a system wait due to an error 
algorithn, te the problem using: 

Queue Headers | 

PFT | 

PT 


locate 


in the page replacement 


Highlights 


® Pages in real storage are replaced as 
replacement algorithn. 

© The Page Manager maintains five queues 

@ The Page Manager will select the least 
replacement. 
To be selected for replacement, a page 


required, using a page 
for page replacement. 
recently used page for 


must be in Q00 or QOT. 


® 

® When Q00 and Q01 are empty, a queue switch occurs. 

® Pages are queued for the page replacement algorithm based on bits 
5S and 6 (reference and change bits) in the Storage Protect key. 


® When paging activity becomes too high, the ‘load leveler' will 
try to deactivate tasks to reduce activity. 

e DOS/VS will attempt Dynamic Reallocation of Partition (DRAP) 
under certain error conditions. 7 

© System tasks, user macros, and Job Control may directly queue 
pages to 900 and Q01 bypassing the hold queue (HQ) for 


performance considerations. 
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Troubleshooting Hints | | @ 


® A PIB flag of X'87' for a task normally indicates a page manager 
| service is being performed for the task. 
® The RETAB bytes labeled TRITLLBG-TRILLF1 are used by the load 
leveler to deactivate a partition. | 
e If a task(s) is in the wait state, check the PSW to determine 


where it was interrupted. If the PIB has a PIB DAT flag with 
bits 6 or 7 on, the PSW is in the partition system savearea 
versus the partition savearea. 

@ The label APNO in SYSCOM (X*CE') indicates the number of active 
partitions. 


IN: DOS/VS Supervisor Logic 
UNDER: Page Management 
READ: | Selection Pool 
7 up to 
Page Handling Routines 
Partition Deactivation and Reactivation 


IN: DOS/VS Base SCM 1 
READ: User Program Performance in Virtual Storage 

Systems 
IN: DOS/VS Error Recovery and Recording @ 

Transients PLM | 
UNDER: Chapter 3: MACHINE CHECK ANALYSIS AND 

RECORDING 7 
READ: S$SRASTOI 
$$RAST13 


SELF-EVALUATION QUESTIONS 


1. When a page replacement is necessary, the page selected should be 


LD EDAD WEEE SED ED TS OED COTE ES AE SD AE SEES ES ATED ED SS 


2s If a page has not been selected for replacement after a scan of 
Q00 and QO1, a oe ____ sd Will occur. 

36 (True/False) The Queue Headers contain the address of the first 
and last PFT entry in queue. 


4. If bytes 2 and 3 are equal to bytes 6 and 7 in a Queue Header 
entry it indicates | ? | 


Ee ip ae CEP eG GED Ce RE CO O_O CE ce CO a eee Ge an 


WN 
e 


The instruction is used to test the setting of 


the reference and change bits. 
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© 6. The load leveler measures paging activity against the constants 
ACONST and BCONST. These constants contain 


FG TT OREROn KOR SEO ANE PEP 


RELA LEED EID EDIE MEG CRIM RCL ETE OULD CEEOL? EASA CRETE GRD CRAEE- CLOTS CAD CENRED <TR LIER CED SETURL 


Te During a DRAP operation, the PT entry for the failing page is set 
to | a 


ER OTD 


8. (True/False) The BBOX is updated after a DRAP operation. 


Refer to the Contents for the location of the self-evaluation question 
answers. | . 
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PAGE MANAGER OPTIMIZATION 


There are several system facilities available to optimize page manager 
operation. This topic will discuss these items. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Identify the macros and their application to optimize: 
ae. Program execution. 
be I/O execution. 
2 Identify any given completion or return code and its meaning. 
Activity 
IN: DOS/VS Supervisor and I/O Macros 
UNDER: | Supervisor Macros 
READ: Write-ups on 
= RELPAG macro 
- FCEPGOUT macro 


- PAGEIN macro 
- VIRTAD macro 
- REALAD macro 


UNDER: | Physcial Iocs 
READ: Write-ups On 
= EXCP 
IN: DOS/VS Supervisor Logic 
UNDER: Page Management 
READ: Write-ups On 


-  PAGEIN REQUEST 
7 = RELPAG and FCEPGOUT REQUESTS 
UNDER: Interrupt Processors 


READ: From SVC 85 through SVC 87 

UNDER: Supervisor Generation and Organization 
REVIEW: ECPREAL parameter of the FOPT macro 
IN: DOS/VS BASE SCM 1 

REVIEW: | Page Manager Optimization 


SELF-EVALUATION QUESTIONS 


1. (True/False) If the FCEPGOUT macro is issued, the affected page 
frames are no longer available in real storage. 


Le When a program iS running in REAL mode and an EXCP..--.,REAL is 
issued, the ‘ | 


RD RROD LEAR CRETE OGD CLD CY ED CTA CED SEEDED ED CD APD EP ED CEE AES SSPE TED ES Ae ENTE I RD ED 
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3. If byte 2 of the ECB contains X'40' after a PAGEIN macro has been 
issued, it indicates 


OD Sr AP CS AES 


4. If a page being processed by RELPAG is found to have 
an entry in the page queue (PGQU), the SVC routine 
will _ | 


SSI CIEE 


e 
AE ED AED ARORA PTO SEER TD AD 


TED ITED CLLRS CIID EP ALT LAD AOD CRI RIND GALT 


Refer to the Contents for the location of the self-evaluation 
question answers. 
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nn «np a Ge a ane eee 


The function of the CCW translation routine will be discussed in this 
topic. For virtual programs, this routine copies and translates the 
user's channel programs into copy blocks in the Supervisor. The 
blocks used are as follows: 

CCWTCB - CCW Translation Control Block 

CCB Copy Block 

CCW Copy Block 

IDAL Block 

FIX Block 


The pages required for the I/O operation are TFIXed and then the 
request is enqueued to the channel queue. 


} 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Locate and interpret the following areas in a storage print as an. 
aid to problem determination. 
CCWTCB 
CCB Copy Block 
CCW Copy Block 
IDAL Block 
FIX Block 
2 Given an OP message, determine whether the problem is in the 
user's channel program or the translated channel progran. 


Highlights 


e DOS/VS must translate virtual CCWs because the DAT feature does 
not function for channel programs. 

Copy blocks are all the same length. 

An IDAL is required if a data area spans a page boundary. 

CCW translation is skipped for: 

- I/O requests from real mode programs 

- I/O requests from system tasks 

- I/O requests from ATTN task 

- Console I/O if console buffering 

- I/O requests via EXCP with REAL parameter 
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CcWw translation will not support: 


® 
- Self-modifying channel programs 
~ Time dependent I/O requests 
- CCWs with length greater than 32K 
~ I/O devices not supported by DOS/VS 
~ Start I/O requests from I/O appendage 
routine when CCWs not translated 

- Channel programs with Data Chaining, 
if cCCWs have different Op Codes. The 
data chaining function uses the Op Code 
of the first CCW only. 

Troubleshooting Hints 

@ Any time a job cancels, the copied CCB and CCW blocks are lost. 

@ To obtain a dump of the copy blocks before a cancel, trigger 
SDAID on instruction fetch of instruction at label ERRI1A. 

@ Standalone dump will format the copy blocks as an aid in 
troubleshooting. | 

e Virtual CCBs and CCWs are always translated unless the REAL 
parameter is specified in the EXCP. 

@ System throughput can suffer severely if not enough copy blocks 
are assigned. See DOS/VS System Management Guide for planning 
information. | | 

® The TCB may contain important information if the CCW translation 

| routine loses control. 

Activity 

IN: DOS/VS Supervisor Logic 

UNDER: Physical Input/Output Control System (PIOCS) 

READ: Channel Program Translation 

IN: DOS/VS BASE SCM 1 

STUDY: CCW Translation Section 


SELF-EVALUATION QUESTIONS 


1. 


1s 


Ss 


4. 


(True/False) The CCW translation routine is interruptable. 


EATS A SET IEE SEPT CIOL: ALS EL IIE NS AIO SATNLE ES STLOY EEL TTT LID PRED Re ee 


The TCB is | bn 


A CCB copy block is bytes in length. 


The Page Frames that are TFIXed for I/O requests are kept track 
of in the _ ‘ 


AED TG ELD CRT, CT OO CTD CATO SEES EE ES A I OE RTE 


‘Refer to the Contents for the location of the self-evaluation question 
answers. 
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RESOURCE MANAGEMENT 


ELLE ELLE CLES LET) LTE 


The concept of resource management and measurement of system 
utilization will be explained. The system components of DOS/VS_ use 
Macros for the reserving and releasing of system resources. These 
resources may be shared or exclusively used. A resource usage record 
table (RURTAB) in the supervisor is used to manage the resources 
between partitions. 


The Job Accounting (JA) interface facility provides job and job step 
information that can be used for charging system use, supervising 
system operation, planning new applications, etc. The customer must 
record the system utilization information on a data set. This JA 
phase will be fetched by Job Control at a job ster or end of job. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Given a system wait state due to a system or operator error, 
locate and identify the problen. 

2- State the purpose of the USE/RELEASE macros. 

as Determine the status of the system resources by interpreting the 
contents of the RURTAB and WAITLIST. 

4. Given a system error in the JA interface facility, determine 
whether the problem is a design error or incorrect usage of the 
facility. 3 

5. Locate and interpret the contents of the following Job Accounting 
Tables as an aid for problem determination. 
= JA Interface Common Table 
- JA Interface Partition Table 


Highlights 


The USE macro is used to reserve system resources. 

Reserved resources can be shared or used exclusively. 

The RELEASE macro is used to free reserved resources. 

The USE/RELEASE macro uses the RURTAB and WAITLIST. 

The customer must write his own job accounting phase and 
‘Name it $JOBCTLN. 
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Trouble 


@ 
is X'82* and t 
(OA3F). 
® The RURTAB can 
a resource and 
being shared. | 
e 
caused by the 
® If $JOBACCT ab 
the next IPL. 
@ If the user wr 
(tape or card), 
supervisor gen 
assignment of 
Activity 
IN: DOS/ 
UNDER: | Chap 
READ: 
UNDER: chap’ 
READ: 
IN: 
READ: 


shooting Hints 


A task is waiting for a system resource if its PIB flag 


is PSW in the save area points toa SVC 63 


be used to Mcterwing the task(s) using 
whether it is being used exclusively or 


If the job name in a dump is $JOBACCT, the dump was 


user JA routine. 
orts, Job Accounting is inactive until 


ites his JA records on unit record devices 
, he must assign the recording device at 
eration time. Job Control will not allow 
unit record devices between partitions. 


vS System Management Guide 
ter 3: Planning the System 
Roe Accounting 


ter 10: Using the Facilities and Options 
of the Supervisor 


Job Accounting Interface Information 


re Supervisor Logic 


SVC 63 

SVC 64 

Job Accounting Interface Common Table 
Job Accounting Interface Partition Table 


SELF-EVALUATION QUESTIONS 


The USE macro 


(True/False) 
being shared b 


(True/False) 


The number of 
without multit 


If the WAITLIS 
for the 
The user's JA 

Control. 


interfaces to the system with an SVC ees 
Ak request for exclusive use of a resource that 1s 
etween partitions can be satisfied immediately. 
The address of the RURTAB is in SYSCOM. 
entries in WAITLIST for a 4-partition system 
ALG Os ill: Et a eee 
T contains X'C097* it indicates the task is waiting 
__._ resource. 
phase is fetched by _ phase _._.... Of Job 
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Te The indicator for job or job step record is 


in 


Table. 


EE EES ACT, CLEA: CEE EUTEE: 


8. The Job Accounting CPU duration is computed 


ae 
b. 
Ce 
d. 


CPU Timer 
TOD Clock 
Tnterval Timer 


Wall Clock 


9. When the user's program receives’ control, 
point to the JA save area. 


located at 


SEPALS OTD SERED SEE ATI SET 


using the 


Register will 


TE ERE ty ED 


Refer to the Contents for the location of the self-evaluation question 


answers. 
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DASD_FILE PROTECTION AND SEEK SEPARATION 


The DASD File Pro 
from attempting to 
currently being a 
specified for the a 


The Seek Separation 
CCW from its chaine 
separately schedu 
disconnect from the 
can then service ot 


OBJECTIVE 


Upon completion o 
documentation, shou 


SP” List the super 
in providing D 


tect feature is provided to prevent user's programs 
read or write outside the limits of the DASD file 
ccessed. These limits are defined by the extents 
ccessed file. 


feature enables the supervisor to separate a_ seek 
d search read or write CCWs so that the seek can be 
led. This enables the disk control unit to 
channel during the seek operation. The channel 
her devices during this free time. 


f this topic, the student, using the available 
ld be able to: : 


visor generation macro and paramters that are used 
ASD file protection. 


eS Locate and identify in a core dump all control blocks, within the 


supervisor, th 
a List the super 


waa are used in pr 


u. Explain the te 


‘ Locate and ide 
program cont 


5 
separation. 
6. List the condi 
being performe 


at are used in implementing DASD file protection. 


visor generation macros and their parameters that 
oviding the seek separation option. 


rm long seek as it applies to DASD file protection. 
ntify in a core dump all supervisor and problem 
rol blocks that are used in implementing seek 


tions which will prevent a seek separation from 


DASD FILE PROTECT 


Highlights 

@ DASD file prot 

© 

@ The upper and 
in the JIB tab 

e DASDFP protect 


d. 


ection is a supervisor generation option. 


DASDFP is an operand of the FOPT macro. 


lower limits for DASD file protections are _ stored 
le at OPEN time. 
s only to the cylinder, not to the track. 
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IN: DOS/VS Systems Management Guide 
UNDER: Chapter 3 

READ: DASD File Protection %.22. 

IN: DOS/VS Systems Generation 

READ: DASDFP Option in the FOPT Macro. 7.24. 
IN: DOS/VS Supervisor PLM 

UNDER: Job Information Block (JIBTAB). 

READ: | Notes 1, 2 and 3 


SEEK SEPARATION 


Highlights 
@ Seek Separation is a supervisor generation option. 
® This option provides increased process and/or available 


channel time during the time a seek is completed ona 
DASD device. 


Activity 

IN: DOS/VS System Management Guide @ 
UNDER: Chapter 3 i ht 

READ: Seek Separation oe 

IN: DOS/VS BASE SCM 1 yr 

READ: Seek Separation Explanation 

IN: DOS/VS Supervisor PLM 

UNDER: Physical Input/Output tl a ca 

READ: Seek Separation 


@ Check bit 7 of byte 12 in a CCB to determine if a failing DASD 
I/O operation was using SEEK SEPARATION. 


SELF-EVALUATION QUESTIONS 


1. Under what supervisor macro can DASD file protection be specified 
at system generation time? _ 


2s What do the (n,n) parameters siqnify in the DASDFP specification 
of the macro? _ v| onblcols 


T42 


10. 


11. 


12. 


13. 


Write the DASDFP= parameters that will generate a supervisor with 
only selector ew ig 1 being file protected for both 2311 and 
2314 pasp. DASDP: 


Which program, user or supervisor, checks to make sure the first 
CCW in a channel program is. a long seek when DASDFP or SEEK 
Separate has been optioned? _ DAA eee: 

Is the user's CCW for the first seek to disk in a channel program 
used to do the actual seek when DASD file protect is supported? 
(Yes/No) > eee 
In what control block in the supervisor are the upper and lower 
limits for DASD file protection stored? <) 71 


block asked for in the preceding question? 


Which table in the supervisor contains a O° ete to the control 


e 


Under what supervisor macro is the parameter for seek separation 
found? 


What can the ‘'n't option be used for when specifying seek 
separation? 


AS AY NS AA A AP AS A ES A A TS A AS ED PS SN ES A I AS A ST A A ANTS AD SLY T-ASE NED A SY LS AR SY AN TD 


(LS. 


NE ERD AED ED CTT CED AOD AND AY PANY A LS OS NS A SS PS AS AY A TS A A TS SV ANS A A AY A LS TP Le SS A A ST 


What is the name of the block in the supervisor that is used 
keep track of the disk address when using seek Separation? 


At what hex displacement in SYSCOM is the pointer to the Seek 
Address Block (SAB) located? X' S@ ¢ 


List four conditions which will prevent a seek separation on a 
DASD device. 


AAAI MEY Sete IETS OLED CD LD STD AORTIC STS LT NY LAD I ETD AN RD AR ED AP ASTD CES RD AES ES 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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SYSTEM FILES ON DISK 


System logical units (SYSRDR, SYSIPT, SYSLST and SYSPCH) are normally 
assigned to the reader, printer and punch. In some instances, it 
could be advantageous to assign them to a disk extent. For example, 
if SYSPCH was assigned to a disk extent, the assembled output from a 
language translator could then be written on disk instead of being 
punched into. cards. This would result in faster retrieval of 
intermediate data and a subsequent saving in cards. This feature also 
affords extended support for the Procedure Library allowing insertion 
of in-line data to a specific job strean. 


This feature is activated by specifying SYSFIL=YES a System 
Generation time. MS 
Ne ov 
a“ 


OBJECTIVE N 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Determine if a supervisor will support system files on disk when 
oe, .given a supervisor listing. 

2s Locate the Disk Information Block (DIB) in a supervisor listing 
i and define its function. 

3. . Locate the cause and take the necessary corrective action for any 


; error when given an error printout and listing of Job Control 
\ cards that utilize the system files on disk feature. 

4. . Determine if a disk dump of SYSIN file is in the correct format 
and sequence. 


Activity 

IN: DOS/SVS System Management Guide 

UNDER: Chapter 5 - Controlling Jobs 

READ: = System Files on Tape, Disk or Diskette 
= System Files on Tape 
= System Files on Disk 

IN: DOS/VS Base Student Guide (this manual) 

DO: WORK PROJECT 11 - SYSTEM FILES ON DISK 


haat Sole Bhat soe pus ste noen cReraehat nape Palen aR cn \ 
saver pdtv LAA EAA ARNETTE NNT NEE NEED 


kK. un ‘WAX 
cur hoo item. “Boe Unie 
1Midp 


yo) SFIS Qu sano Raw. 
_ 1 We Sebue. 


Refer to the Conten 
answers. 


card read 


| © SELF-EVALUATION QUESTIONS 
1. Under what macro is support for system files on disk specified at 
system generation? | 
Ae SUPVR 
b. SYSFIL- 
Ce CONFG 
d. PIOCS 
eC. FOPT 
Ze In the macro parameter given below, what is the residual capacity 
of the file OE SYSPCH? 
SYSFIL=YES 
ae 500 
b. 2400 
Co 1500 
a. 1000 
3. When assigning SYSIN to disk, what type of assignment must be 
made? 
A. Temporary 
b. Permanentl” 
4. At what hex displacement into a partition communication region 
e can the address of the DIB be found? X! a 
ae x'96! 
b. x'50! 
Ce xX'500° 
d. xX'60! 
e. x'98st 
v 
as (True/False) The DIB table is a by physical IOCS and each 
time a PCIL is assigned. 
6. The following command: “CLOSE SYSIN,X*0O0C! 
ae Is invalid 
De Assigns X'00C' as the SYSIN device 
Cs Closes the SYSIN file X'0O0OC! 
d. Closes th 


e SYSIN file and reassigns SYSIN to the 
er. Vv 


ts for the location of the self-evaluation question 
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LIOCS CONCEPTS/MACROS 


Most data processing I/O is accomplished by using IBM supplied routines 
which are collectively called the logical input/output control systen 
(LIOCS). These routines provide macros for converting customer I/O reqiests 
into the physical I/0 requests that are recognized by the supervisor (EXCP, 
WAIT, CCB). 


During this topic, the student is introduced to the terms used in 
LIocs, the I/O control tables, and the register conventions established 
for LIOCS. 


OBJECTIVE 


Upon completion of this topic the student, using the available documentation, 
should be able to: 


1. Use the following terms to correctly describe logical files: 
be Physical record 
_ be Logical record 


_e.-- Volume and volume labels 
Gd. Logical file and file labels 
-e@.” Fixed, Variable, and Undefined record formats 
-f. Blocked or Unblocked records 
2. \€orrectly identify the register conventions used by LIOCS. 
3. Correctly identify the usage and/or interaction of the following terms: 
DIF, MOD, GET, PUT, OPEN, CLOSE, EXCP, WAIT, CCB. 
4. Identify the different types of file organization used by LIOCS which 
are Sequential, Random and Index Sequential. 


Highlights 


® The Command Control Block (CCB) for all files processed by LIOCS is 
_ ™“ the first 16 bytes of each DIF table. 
e . Byte 2 in a DTF table contains the code to identify the DTF type. 


@e ~ All labeled files must be opened before processing and closed after . 
\ processing. 

@ ,., Each file in a program must have its own DTF table. 

® Logic modules can be shared by two or more files providing the files 
“ have similar characteristics. 

@ High level languages such as COBOL, FORTRAN, and PL/1 all use Logical 
.’ IOCS. 

Troubleshooting Hint 

® /nefer to the DOS/VS Supervisor and I/O Macro SRL under Register usage 


for register significance using LIOCS. 


Quan: 
“ . 
YX ok 
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@ Activity 


In: Supervisor and I/O Macros 
Under: Macros Processing 
Read: DIF Declarative Macros 


Logical Module Generation Macros 
Register Usage 

Under: Label Processing 

Read: UEnd-of-File Processing 


In: IOcS - Volume 1 
Under: Introduction 
Read: Through MOD Macros and Imperative Macros. 


In: DOS/VS Data Management Guide 
Under: Input/Output Control Systen le— 23 
Read: To Physical IOCS (PIOCS) 


SELF-EVALUATION QUESTIONS 


@ 
CAPE CNS GATED OD ED CAE AR CRE a aD 


Ls The CCB expansion is part of the NTF 


KKMOD 


2 The EXCP and WAIT macros are generated as part of the 


3. Upon linkage from a GET to LIOCS, regist RO. tien 
the address of the wr) area, register T= contains the MOD 
& address, ee a _. contains return address, and 


register contains the address of the DTF. 


5. A blocked record contains multiple 
logical) records. 


Use the following terms to answer question 6 through 8. 


ae Card file 
b. Print file 
Ce Disk file 
d. Tape file 


6. Which of the preceding file(s) can have volume labels 2 IKs ve - 
(More than one answer may be correct.) 
270 E- 
7. Which of the above file(s) can contain multiple volumes 2 Dis 2 ae 
(More than one answer may be correct.) 
8. Match the above terms to the following record formats which may be 


used to record on these files. (More than one answer may be correct 
for each blank). 


2. DISK Jove _ Fixed blocked © La NOTA 


Fixed unblocked 
_ variable blocked MOTOR 


«Variable unblocked 


abeed | oe 


10. 


ll. 


12. 


13. 


End-of-file can be identified by _ on a card reader, | on 


1050, __T™™ on tape, on printers, and 
on DASD devices. | 


ALY ETE ELD ALD CARAS LEAT ELD LENNY CERT MELD TD IN 


Place in sequence the events needed to cause an I/O operation on an 
output unit record device (PUT) using a work area. 
Note: Some items are incorrect and therefore not used. 


Ave _.._.____._ rssue an EXCP macro from the DTF. 

b. __.. Return to the DTF after the successful execution 
| of the EXCP macro. 

Ce os __. Exit to the logic module from the PUT macro expansion 

| to the problem progran., 

d. ____tS:«CMe@ «the work area to the I/0 area. 

e. si iExit to the logic module from the PUT macro expansion 
o. in the DTF. 

f. __«CMOOVE the T/O area to the work area. 

Ge Issue an EXCP macro from the problem program. 

h. Issue an EXCP macro from the logic module. 


ne anne 
i. __ a Return to the problem program from the logic module. 


Which type of file organization can be processed both randomly and 
sequentially? | 


Name three types of po forge en aarnon methods available in DOS. 


4) 


perma HSE na 


What is the blocking factor if the logical record size is 60 bytes 
and the physical tape record is 300 bytes? 


Refer to the Contents for the location of the self-evaluation question 
answers. 
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®@ UNIT RECORD FILES/MACROS 


Most data processing I/0 is accomplished by using IBM supplied routines 
which are collectively called the logical input/output control system 
(LIOCS). These routines provide macros for converting customer I/O requests 
into the physical I/0 requests that are recognized by the supervisor 

(EXCP, WAIT, CCB). 


During this topic, the student will be introduced to the terms used in 


LIOCS for unit record files, the I/O control tables, and the register 
linkage conventions established for LIOCS. 


OBJECTIVE 


Upon completion of this topic the student, using the available documentation, 
should be able to: 


1 Correct all coding and/or logic errors in any program using LIOCS 
| macros for card and/or printer operation. 


Zs Correct any errors caused by incorrect expansion of DTFCD, CDMOD, 
DTFPR, PRMOD, or imperative macros. 
au Use the correct PLM to identify correct operation when given a failing 


program or routine. 
sae pe the following items in a DTFCD or DTFPR table: 


- CCB )— 
- Address of logic nodule ge ys 


- DTF type 
© - Address of 1/0 areas 2U-2}. 
- CCWs ’ 
5./ Determine the DTF type code, using the PLM, when given a DTF ina 
storage print. 
6. Identify by name any DTFxx macro provided for LIOCS and indicate the 
Ta physical file types processed. 


Highlights 


@ The Command Control Block (CCB) for all files processed by LIOCS 
is in the first 16 bytes of each DTF table. 
® Byte 21 (displacement of 20) contains a code to identify the DTF 
type. 
® All labeled files must be opened before processing and closed 
after processing. 
OTPx A Every file in a program must have its own DTF table. 


Logic modules can be shared by two or more files, if the files have 
/ Similar characteristics. 
yo High level languages such as COBOL, FORTRAN, PL/I, and RPG all use 
Logical I0CS. 


Troubleshooting Hint 
® Refer to the DOS/VS Supervisor and I/O macros SRL Register Usage 
@ for register significance while using LIOCS. 
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Activity 
In: Supervisor and I/O Macros SRL 
Under: DTF Declarative Macros 


Read: “DT FCD 
APPR 
/GDMOD 
VeRwoD 
Under: Processing Macros 


Read: \/CNTRL Macro 
\ PRIOV Macro 


In: OS/VS LIOCS - Volume 1 
Under: mperative Macro Expansions 
Read: CNTRL Macro 

Under: Declarative Macros 

Review: y DIF Table Types { :Aly- 
In: DOS/SVS SCM3 

Review: Unit Record Files/Macros 


SELF-EVALUATION QUESTIONS 


1. If byte 20 of a DTF contains a X'08' this file is: @ 


a. DTFCD reader file (0% O03 ou 
b. DTFCN console 

c. MTFCD combined file 

d. ,DTFCD punch file 

e. v DTFPR printer file 


2» The DTF 7 a supports what device type? _ Up liel KUNIS | 
ana LUE Wistipen Hino -4 es 
3. The CCWs used in LIOCS are contained in what LIOCS element? 


ae CCB 

b. Logic Module 

Ce YY DIY. 

d. GET and PUT macro 
e. Supervisor 


4. When is the logic module address in the DTF table (bytes 17-19) 


resolved? ” 

Ae During execution of the OPEN Y 

be During execution of the CLOSE 

Ce During the assembly of the program 

d. During linkage editing of the progran 

e. During execution of the first GET or PUT macro 
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specified. (There is only one correct answer for each area.) 


7 
(True/False) When an end-of-file is sensed on an input device, 
the EOJ macro is issued, by the logic module. 

— ha stk 22 
The standard name generated for the PRMOD is EIDECZEY This 
indicates support for which of the following? HOES han one 


answer, ,is correct.) ee a 
a Poni =4GS E C.-2 - by 


b. X. ERROPT 

Cc. \VWORKA =1(5 

d. \PRINTOV=YeS 

e. XIOAREA2 

f. »« Variable unblocked records »~ 
ge » 3211 printer 


Match the locations on the right with the areas they point to on the 
left. Use the DTFPR table as a reference. Assume a 1403 with STLIST 


Winters. 210:4: 


1. IOAREAL C DTF Bytes 40-47 
2. /-Print CCW - ee tt eee DTF Bytes 17-19 
3.  Workarea @ 733s eee _c. DF Bytes 24-27 —- 
4. Logic Module Addrb oe _ d. DIF Bytes 34-37 


je. __GET/PUT macro expansion 
fs DTF Bytes 49-51 


Refer to the Contents for the location of the self-evaluation 
question answers. 
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MAGNETIC TAPE FILES/MACROS 


The use of LIOCS macros to process magnetic tape files releases the 
problem programmer from the burden of maintaining maximum channel 
utilization, blocking/deblocking physical records and handling various 
physical record types. The problem programmer can now concentrate on 
the processing of one logical record at a time. 


OBJECTIVE 


Upon completion of this topic the student, using the available documentation, 
should be able to: 


i. Locate and correct any errors in a program caused by an incorrectly 
coded DTFMT or MTMOD. 

2 Select the appropriate detail flowchart (PLM) for imperative 
Macros. 

3. Determine from the operands of the DIFMT the name of the logic module 
required to support tape files. 


4. Identify, from a list of statements, the use of the following macros 
and operands, when processing variable length tape records. 
- Macro 
- TRUNC 
~ RELSE ; - Of 
— DTFMT : Mix. Abie Mi + 1 PUURA. 
~ VARBLD= well, Ro . 
- IOREG= 
- IOAREAI1= 
- WORK A= 
Highlights 


@ the, Command Control Block (CCB) for all files processed by LIocs 
is in the first 16 bytes of each DTF table. 
e@ /,/Byte 21 (displacement of Decimal 20) contains a code to identify ‘the 
vv PTF type. 
® wa ‘All labeled files must be opened before processing and closed after 
Processing. 
e VV Bvery file in a program must have its own DTF table. 
e /, Logic modules can be shared by two or more files, if the files have 
VY Similar characteristics. 
@ /fHigh level languages such as COBOL, FORTRAN, PL/I, and RPG all use 
\ / Logical IOcSs. 


® The proper rere macro expansions can be found in the LIOcS PLM 
Volume l. 
® By referring to registers 1 and 14 in an automatic system dump, 


caused by a LIOCS or a device error, the DTF address of the file 
in error and the linkage macro in the problem program from which 
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r this I/O request was made can be determined. 
e By using the SUPVR and I/O macros SRL to breakdown a LIOCS module 
name the device type and the options that the module will support 
can be determined. 


Activity 


In: Supervasor and I/O Macros SRL 
Under: _. Sequential Access Method 
Read: _ DI FMT Macro Parameter 
vError Options 
wMTMOD Macro Parameters 


a” 

In: LL ‘LIOCS - Volume 2 

Under: Magnetic Tape Files 

Read: MTMOD Macro Through Error Option Extensions 
Data File Charts on MOD Expansions (10 charts) 

In: SCM 3 

Under: ,° Magnetic Tape Files 

Reads: Entire section 


SELF-EVALUATION QUESTIONS 


1. When does a GET macro cause a physical record to be read? 


SR ED RS EP ED EE ED SEED ED OEEED END SOD NED ED ED RD EP ED EP EEE CEEED AED ED ERD AED NEP AD AD ED AD NS SY AP A LS SS ae SS A Te TP Te 


Use the following DIFMT parameters to answer questions 2 through 8. 


TAPEOUT DTFMT BLKSIZE= 320, DEVADDR= $1503, 4 
FRROPT=ERRUY, FILABL=S1D, v 
IOAREAI1= OUTPREAY RECFORM= FIXBLK, 
RECSIZE=80 TYPEFLE=OUTPUT WY 


WORKA=YES; IOREG= a 


ance steel tetris ment nate 


2. Will this DTFMT be OE. correctl Yes/N If no, what is the 
error? We 9. IEG, sa ate 


<n ape ee ee ee: a ne mp ae ee A RED FED ED ND SE ED CE OEE ED 


For questions 3 through 8 consider the IOREG=5 operand eliminated 
from the DTF. 


3. Is it necessary for the user to write a routine to handle 
errors? Wks a vir LRT 
4. How many logical records are there in each physical record? 


<> cen anes ee ae a On Pe ae a ee eee eee A AS AA AS APS TS A DS A eS PS EP NED ND END COONS ENED <AUOND 


Mingo fw dhe SE: TIFF FEW 
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5 


11. 


12. 


Match the following macros and operands with their uses. 


Macros 
TRUNC 
RELSE 
Operands 
___ VARBLD 


IOREG 


 IOAREAL 


_______-~-WORKA 

ae Used when no work area is specified. 

b. Used to write a short block on tape. 

c. Used when records are processed in a work area. 

d. Specifies the name of the I/O area. 

e. Used when variable-length records are built in the I/O area. 
f. Used to skip input records. 


What MTMOD name would be generated to support the prF2 tt 2We 


? 
The size of the work area in bytes is _ 2097 @: _ (decimal). 
4, 


To assemble this DTFMT Beparatery the  °* 
operand must be specified. 


LEAL LD EY LET ETED SLL: AY LTD TE LED LETLLELELLIS SLED LT TELL LEED LILLE LED PLT EES SER: LY 


The PLM flowchart which explains the movement of data from the 

I/O area to the work area when processing tape files with 
fixed-length records is ___ Sen fe Sneha 

What bytes in a DTF contain the logical record size? (Assume ee 
a tape file with fixed blocked records). __ through oe . 
Which bytes in a DTF contain the physical tape record size? 
(Assume an output tape with fixed blocked records.) Bytes 
through 


Which of the following points to the current logical record when 
using blocked tape records? 


a. I/O AREA l 
b. I/O AREA 2 
c. I/O REGISTER 14 
d. REGISTER 14 
e. REGISTER 15 
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13. Which of the following most accurately describes a tape file whose 
DTF table has an X'7D* in byte 21? 


Ae 
b. 
Ce 
d. 
e. 


Unblocked records, output, forward 
Blocked records, two I/0 areas, workarea, input, backwards 
Unblocked records, one I/O area, input, backwards 


Blocked, one I/O area, output, backwards 


Blocked, two I/O area, no work area, input, forward 


Refer to the Contents for the location of the self-evaluation 
question answers. 


jal ca ee Tae Z lene Tat UD bgt, resents, 
y tXe fw 


MAGNETIC TAPE LABELS @ 


SRA GREND CHREOEE CED AED AND AOR ER YD ERS EE aS EID AEE ED anenen 


Data file protection is a problem that concerns all users of DOS. Data 
management provides the programmer with a method of checking each type 
file prior to writing or reading it to ensure that no tape file is in- 
correctly used or destroyed. This topic will teach the student how volume 
and file labels are used to give the user this control. The student will 
also learn how to identify the label records and the concepts of 
file-label processing. 


OBJECTIVE 


Upon completion of this topic the student, using the available documenta- 
tion should be able to: unuidun ulic INTT | 


Ju Determine the appropriate IBM utility to print out the volume label, 
? header labels, etc, from a reel of tape. 
re Identify the various types of standard labels on a tape file. 


3e Locate and correct any errors in label set cards when a label error 
~ message is printed by the systen. 
4 Identify the contents of the various fields when given a printout 

d of a standard tape label. 

5 Locate and correct errors in a label processing routine of a progran 
Y caused by an incorrectly generated or coded DTFMT or MTMOD. 

6. Identify the function of a // LBLTYP card when processing tape data 
: files. 

Ts State in his own Viton the correct use of the LBRET Macro. 

LBReT  §4/2133 Qin. 
tins Veo Ate 
Highlights lord Rives Pres 
7 Led EL GH. 


ee IBM STANDARD LABELS are written and checked by B transients as a 
VY result of the problem programmer coding the ‘OPEN’ and "CLOSE! 
macros. 

@ - The customer may supply additional standard labels that will be 
. written or read by LIOCS, but must be checked by a user routine. 

Nov Tape labels are processed automatically during automatic volume 

i switching. 

e ~ LIOcCS neither reads, writes, or processes nonstandard labels. 

VY THEY ARE THE RESPONSIBILITY OF THE USER. —= 


® Investigate all messages in the operators guide. 

@ Use the MESSAGE CROSS REFERENCE in LIOCS Volume 1 and 2 in 
conjunction with the PLM charts to determine why an error 
message was issued. 

e Use the PDAID Fetch/Trace feature in conjunction with the high 
level charts in the PLM to trace the oECcE of the label process- 
ing transients. 
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Activity 


In: 
Under: yp 
Read: Vv 


In: 
Under: 
Reads: 


In: 
Under: 
Review: 
Under: 
Review: 


In: 
Reviews | 


LIOCS = Volume 1 
Tape Labels 
From tape Labels through Unlabeled Tape Files 


Supervisor and I/O Macros 

Label Processing | 
Tape Labels through Unlabeled Input Files on Tape 
LBRET Macro usage. 


| LIOCS - Volume 2 


Magnetic Tape Files 

DTFMT Macro Expansion Fields 
Initialization and Termination 

Tape open/close and EOF/EOV Routines 


DOS/VS SCM3 
Magnetic Tape Labels 


SELF-EVALUATION QUESTIONS 


te The type of labels used on a tape file can be determined by looking 


at 


ae 
b. 
Ce 
d. 
Ce 


2. If 


the DTF contain a block count. 


ae 
b. 
Ce 
d. 
e. 


byte number 


of the DTF. 


0 

16 
21 
32 
36 


standard labels are specified for a tape file, byte 40-43 of 


The block count is the total of: 


Logical eccouies” 

Logical records and tape labels. 
Physical record and tape labels. 
Physical record. 

Logical records, labels, and tape marks. 


3s Which one of the following control cards is used to reserve a 
label work area in the problem progran? 


Ae 
b. 
Ce 
de 
Cn 


// TPLAB 

// TLBL 

// “LABLTYP (01) 
J/ LBLTYP vy 
J/ VOL | 
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How many bytes of the problem program's area are required by the 


open routines for label processing? 


ae 84 bytes 

b. 80 bytes .. 

roe 80 bytes for each tape file in the programw 

d. 80 bytes for the first tape file and 20 bytes for each 
additional file 

e. 20 bytes 


List the required job control cards in the proper sequence to 
catalog a group of TLBL cards onto SYSRES for a foreground 2 
progran. 


(1)  _ Start F2 _ a. {> // Job catalog 
— bp. 76 
(2) __ c. // EXEC STDLABEL 
d.(4} TLBL(s) (as many as desired) 
(3) e. // OPTION CATAL | 
£. // OPTION USERLABEL 
(4) __ g. // OPTION STDLABEL 
ha // EXEC PAKSTD 
(5S) i. 72 // OPTION PARSTD 
j.  // END 


Which of the following items are useful in a tape file header label? 


a. Block count AY Peat baile HIK ant | 


be.” Expiration date wv 


Cx Alternate tape address. 
ds’ Creation date vy 


£. VTOC Address 
Ge DTF Filename rv, 


On a multi-volume file, the last volume must contain a gf 
(EOF/EOV) label and all preceding volumes must contain a Yo _ 


(EOF/EOV) label. 


Identify the various labels by inserting the correct label type in 


the volume layout below. (all standard labels) 


Load 
Point 


mons UL 4 


Label Label 


for File A | for FileA 


TM = Tape Mark 
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10. 


The program may be used to print out the label 


information from a reer of tape. 


EOFISAMPLE TAPE OUT naa 


11 


001/000 


vse) Se GEN Ch | KP 
$001 oy 70023) 7036 


Determine from the above printout of a standard label: 


ae Creation date 10988. = RIAN 

b. Number of records on file _ TT 

c. Type of label €64 

d. File serial number Jif 

e. Expiration date An hi = Y Cf 4 
f. The number of reels in the logical file 


TAPEOUT DTFMT BLKSIZE=30 
ERROPT=ERR 
ITOAREA 1700 
RECSIZE=10 
WORKA=YES, 


ap ep ee ee ee ee eee eee eee eee 


0, DEVADDR=SYS001, k0htagk? 


UT, FILABL=NSTD, 
TAREA, RECFORM=FIXBLK, 
0,TYPEFLE=OUTPUT, 
REWIND=UNLOAD 


Use the above printout to answer questions 11 and 12. 


11. 


12. 


1 3. 


Will the above DTFMT generate correctly? If not, 


error? (Assume all else 


to be correct.) 


oteOpk omittea. HLL waa. 


0 ES EE ET I EE ED SA ED EE ED EE ED A A AAD LA ASD AAD A OS LS LT OT AP A LS RY NS RED 


Using the PLM flowcharts, what will be written on the tape after 


executing the first PUT m 
load point.) 


Veiga. 


Match the labels in the left column with the appropriate statement 


in the right column. 


23 4 a. 
i 3b. 

54 6 c. 

2 t FF 3B d. 
f. 


y- =o Created by initializ 
2. Created by the open 
3. Checked by LIOCS on 


what is the 


acro. (Assume the tape to be at 


Hdr 1 label 

Volume label 

Dummy header label 
EOV/EOF label 

Nonstandard header label 
Nonstandard trailer label 


e tape progran. 
routine on output 
input or output 


aD RENEE CP OEED RIDES CS CED ED CE an EE a ee ee 


QW. Contains information supplied in TLBL or TPLAB cards 


5. Bypassed by LIOCS 


6. Created by a label routine written by the user 


7. Created by the close 
8. Contains block count 


routine on output 
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14. Determine from the list below the correct sequence of events for 
processing a tape output file using standard labels. Assume the 
file to be written is the first and only file. 


a Backspace and write new HDR1 label. 

_._—_—*iDe Problem program writes data record. 

4 A Locate the label set in the volume information cylinder 

for the tape drive to be processed. 

__ Ke. Reads and checks volume label from tape. 

__ Le Close macro issued by problem progran. 

_>. #£. Open transient monitor is fetched into storage. 

ps Ae Problem program issues open macro for tape drive. 
h. Reads the HDR1 label to determine if expired. 

i as Job control writes the label set cards information into 
the label information cylinder. 

k. End of file label written with block count. 


_.._— ile Rewind tape drive. 

__.._—-* Me Logic module counts number of physical records written. 
_. We Write tape mark. 

_..—sOé*~Pe The logic module writes the last physical record on tape. 


15. (True/False) The // LBLTYP card reserves work area for job 
processing labels. 


16. When is it necessary to use the LBRET macro? 


17. LIocs, when handling nonstandard labels, will __ _ 
Tada ts Ades MWA 


¢ 
Ee RED ED ED A ED AND ED ENTE ARATE NS ED CEO ED ED CED PED GN aN OT > AD AS CY EP PS PT AE A A A A aS A AD EN CONTE ceRND ORAS 


EP OE AEE SEP OED AED ED ED ES RD TE EE AT ED AD A A ED A AS A ST TT AT CT TS TY TY LY OY LD SS LD ES SY TD LS TTS AT a a Te 


Refer to the Contents for the location of the self-evaluation 
questions. 


iy 
n v. i . 


gl 
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SEQUENTIAL DISK FILES/MACROS 


The use of LIOCS macros to generate/process a sequential file on a DASD 
device greatly reduces the volume and complexity of coding in the 
problem program for I/O processing. The generated module will develop 
successive DASD addresses and automatically handle volume and extent 
Switching. The flexibility of this management system also allows it to 
be used to process files created by other LIOCS file management systems. 


OBJECTIVE 


Upon completion of this topic the student, using the available documentation 
should be able to: 


wa Write the macros and/or operands of a DTF or MOD to generate the proper 
coding for any given sequential disk file. 
2.” Locate any given entry in a Sequential disk DTF or MOD. 
3. ,Locate and correct, in any given imperative sequential disk macro, 
“ any coding or expansion failure. | 
taf OCes and correct LIOCS program failures for a sequential disk file 
caused by incorrect expansion of a DTF or MOD macro. 
5< Determine from the DTFSD operands the name of the MOD required to 


' ——— Support the sequential disk file. 


Ul 
FL 

dr Aawllegt 
@ 


6. /Determine from the ERROPT and ERREXT operands of the DTFSD the error 
a recovery procedures to be used for a sequential disk file. 
"A 


2 SKIP MaNIOE, ARO, ALYTING BH prbuE 


Highlights 

e All three data formats are supported ie fixed, variable or undefined, 
blocked or unblocked. 

@ IOCS generates successive disk addresses to access data records 
sequentially. 

® Data records containing keys are not supported. 

@ DASD sequential files may be accommodated on the IBM 2311, 2314, 2321, 
3330 and 3340 DASD devices. 

Troubleshooting Hints 

@ The current seek search argument is stored in the DTF. 

@ Use a utility to list the data tracks of the file to determine if: 
se The file was actually created. 
2s The record formats conform to specifications. 

® Change the extent information to utilize a blank section of the DASD 
device to ensure that the data being listed by DASD printer was 
written by the LIOCS program in question. 

® Refer to previous topics for further troubleshooting hints. 

@ Check the OPEN/CLOSE indicators for the status of the file. 

e The displacement into the MOD determines the type of operation. 
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Activity 


UNDER: 


REVIEW: 


IN: 
READ: 


LIOCS VOL 2 
Sequential Access DASD Files 
Introductory Material through Module Save Areas. 


DOS/VS Data Management Guide 
Record formats for DOS/VS 
Through Spanned Record (Format V) 


DOS/VS Supervisor and I/O Macros 

Declarative Macros 

DTFSD macro and operand meanings 

SDMOD macro and operands 

Imperative Macros 

GET, PUT, TRUNC, CNTRL, ERET, OPEN and CLOSE macros 


DOS/VS SCM 3 
Sequential Disk Files 


SELF-EVALUATION QUESTIONS 


1. When may a PUT macro be issued to a sequential disk input file? 


appear a eee 


A DIF table has a X'20' at a displacement of 20 (decimal) into the 
table. What bytes (decimal) contain the latest search address 
(CCHHR) ? _ | 


Which bytes of the DTF for a sequential disk file contain the 


symbolic file name (decimal)? 


Use the following to answer questions 4 through 7, given the following 
DTFSD parameters: 


BLKSIZE=240, RECSIZE=80, ERROPT=IGNORE, EOFAIDR=EOFDK, IOAREA1=DSKOUTI, 
IOAREA2=DSKOUT2, RECFORM=FIXBLK, TYPEFILE=OUTPUT, IOREG=09 


The output area required is _bytes (decimal). 


What module name will be generated to handle this DTF? _ 
What superset name could be used to support the maximum functions 
including the above DTF? 


AEDT GND PAD GD CP A OAD LD a ae AS SY A ST AP SP 


(True/False) The user must include a device error recovery routine 
because of ERROPT=IGNORE. | 


The operand must be specified if the user does not 


want a job terminated because of unrecoverable I/O errors. 


To allow a problem program to return to the SDMOD using the ERET 
macro, the operand must be specified. 


np ann anu) a Gabe eee 
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10. 


11. 


12. 


13. 


(True/False) The ERREXT operand can be specified without the ERROPT 
operand. 7 —- 


A logic module with the name IJGFIEZY had which of the following 
operands specified? 


a. HOLD=YES 
b. RDONLY=YES 
Cc. RECFORM=SPNBLK 
d. TRUNCS=YES 
e. ERROPT=YES 


Entry into the SDMOD at a displacement of 000C is for processing 
which macro? 


Ae TRUNCS 
be. $$ CONTROL 
Ce GET 

d. PUT 

eC. RELEASE 


If ERROPT=name and ERREXT=YES are specified in the DTFSD, on entry 
into user routine register 1 points to a parameter list, this 
parameter list contains: 


Refer to the Contents for the location of the self-evaluation 
question answers. 
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} SEQUENTIAL DISK LABELS 


The use of labeling on disk files gives the user a means of protecting his 
files against being accidentally destroyed. 


The format of the disk label set as written by job control on the label 
information cylinder is discussed during this topic. The logic behind 
opening and closing DASD files is presented showing the relationship 
between the DTF, the label information cylinder, and the VTOC. Exiting 
to the problem program for processing user labels is discussed with 
emphasis on what functions LIOCS will perform and what routines the 
problem programmer will supply. 


OBJECTIVE 


Upon completion of this topic, using the available documentation, 
you should be able to: 


1. Use the DASD print utility to locate and print out the VOL label, 
all labels in the VTOC, and the label information cylinder. 

2 Determine any files location and size, using the labels contained 

in the VTOC or lable set cards. 

36 Locate and correct any errors in label set cards when a label error 
message is printed by the systen. 

4. Obtain a system dump containing any failing OPEN or CLOSE transient. 

Se Identify the control statements necessary to catalog standard 
labels on the SYSRES pack for any partition. 

@ 6— Identify the label information and its layout in the label 

information cylinder. 

Ve Identify what program builds and/or deletes the following labels. 
ae Format 1 labels in VTOC 
b. Format 3 labels in VTOC 
Ce Format 4 labels in VTOC 
d. Volume label 


e. Label information cylinder 
£. User labels 
8. Identify and correct any errors in the use or expansion of the 


| OPEN or CLOSE macros. 
9. Identify where user labels are located on a sequential disk file. 
10. Identify macro parameters needed to process user labels. 


Highlights 


e Label set consists of one (1) // DLBL control statement and at least 
one (1) // EXTENT control statement. 

® Only one extent is opened at a time. 

@ A // LBLTYP card is not needed to reserve core in the partition for 


label records since the open transients read the label record 
directly into the transient area. 
® Only IBM standard labels are processed by LIOCS Open/Close routines. 
® User labels are allowed and will occupy the first track of the 
first extent. 
® User labels will be read and written by LIOCS but must be built 
and checked by user routines. 
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Trou leshooting Hints 


® Use the VTOC display program (LVTOC) to list the VTOC to determine 
if the label processing failure occurred at output or input time. 


® Use LSERV to list the label information cylinder (LIC) to determine 
if job control constructed the labels properly. 
@ Refer to previous troubleshooting hints for added technigues. 
Activity 
In: Supervisor and I/O Macros SRL 
Under: Label Processing 
Reads From DASD standard labels through writing 
User standard labels on disk. 
Under: Declarative Macros 
Review: DTFSD (LABADDR Operand) 
Under: Processing Macros 
Review: GET, PUT, TRUNC 
In: -LIOCS - Volume 1 
Under: Standard File Label Formats 
Review: Format 1, 3, 4, and Standard DASD Volume Label 
Under: Open Sequential DASD | 
Review: Charts O04, 05, and 06 
Ins DOS/VS Systems Management SRL 
Under: DASD Labeling 
Read: To Labeling of VSAM Files 
In: DOS/VS - SCMS3 
Review: Sequential Disk Labels. 


SELF-EVALUATION QUESTIONS 


1. What routine inserts the unit and class into the CCB portion of 


the DTF? 


2s (True/False) 


STRANI eC SRT PRL LTS PEI AI AAD MES SLA CENT OMENS SPIES | 


specify a minimum of two tracks. 
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If user labels are specified, the first extent must 


4. 


Se 


Match the following programs and/or routines to the function they 


perfora. 
ae __. Builds format 1 label in VTOC 1. Job control 
b. _._._.._.. Builds format 3 label in VTOC 2. Linkage editor 
Ce Builds format 4& label in VTOC 3. OPEN 
de Creates volume label 4. GET 
Ce Builds label information 
cylinder 5. CLOSE 
f. User labels 6. PUT : 
7. j%&Initialize disk 
utility 


8. User written 
label routine 


Match the correct label information to the track in the label 


Foreground two temporary labels 
Background temporary labels 
Foreground two partition standard | 
labels | 
Foreground one temporary labels 
Standard labels - all partitions 
Background partition standard 
labels 

Foreground one partition standard 
labels | 


information cylinder where it is stored. 
Ae Track 0 1. 

b. _. Track 1 2 

Ce Track 2 3. 

d. _... Track 3 4. 

Ce Track 4 5. 

f. Track 5 6. 
Ge _ «Cd FCK «CO To 

he Track 7 

i. _ Track 8 

j. _._.. ‘Track 9 

User labels, if used, will be found 


e 
apenas eres se. eee eeete qe Gene eeene ewe a 


Indicate the correct sequence of the following label cards to do 
a standard label run for an output file on SYS005 and an input 
file on SYS006 in that order. 


// DLBL DISKOUT, ‘SEQUENTIAL DISK FILE.',75/001,SD 


// EXTENT SYS005,111111,1,1,1600,1 

_ // OPTION STDLABEL 
// DLBL DISKIN, ‘SEQUENTIAL DISK FILE.',75/001,SD 

// EXTENT SYSO006,111111,1,1, 1600, 1 | 

// EXTENT SYSOO05, 111111,1,2,1601,9 


// EXTENT SYS006,111111,1,2,1601,9 


DOS/VS will accept which of the following label cards? 


Ae 
be 
Ce 
d. 
eC 
f. 


J// WOL 
// DLBL 
// DLAB 
J/ EXTENT 
// XTENT 


All of the above. 
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10. 


V1. 


12. 


13. 


14. 


Reference the label cards in question 6 to answer this question. 


How many tracks are there on the unit assigned to SYS005 that 


are part of the file "SEQUENTIAL DISK FILE.'? 


ESTED EELS CEE CA ASST 


The disk address of the label information cylinder can be found 


in the communications region at a displacement of 


What control cards are required to use the VTOC display utility 


(printer output) ? 


TE LED CSD EP RENT ED GS ETS GDI Ewe CO RE TREE EPS OEP ARENT CUE RTA LEE ARLE EAD CERI ED NES AIL SSP SE ALLEY SETLIST SEED 


EEL LD LEP LEE LLL ETE LED LES ETL ENED EEE LS SEL AILLEED LLERE LIED CLD 


Where is the address of the volume table 
on all disk packs? _ 


of contents (VTOC) found 


A ED 


Which bytes of the DTF for a sequential disk file contain the 


symbolic file name? _ 


What format type file label contains the 
a sequential disk file? 


ae One 
be Two 
Cs Three 
d. Four 


Ce Five 


first extent limits for 


Where can the extent limits for the volume table of contents 


(VTOC) be found on all disk packs? 


As Format four label 
b. Volume label one 
Ce Format five label 


d. The first format one DASD file label 
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15. Given: The 20 cylinders on a disk file (cylinders 1 through 20). 


Write the split extents to give SYS001 tracks 0, 1 and 2 of all 
cylinders and SYS002 tracks 3, 4 and 5 of all cylinders and 
SYS003 tracks 6, 7, 8 and 9 of all cylinders for an SD file. 
The VOL serial number = 222222. 


aw 
PS ED PAS TD SS CTS OD POD SS PT TTS a TTS aD AP Se aS LP ATS NT Te TT yD ea eT eT I 


Ce 


ALD ATT EMERY ELI LGD LEAD CTS LD CEL TEES 


Refer to the Contents for the location of the self-evaluation 
question answers. 


169 


DIRECT ACCESS DISK FILES/HACROS 


The direct access file management system provides a flexible set of 
macro instructions for creating and processing a data file on a DASD 
device. Although this file management applies specifically to data 
records organized in a random order, it can also be used to process 
records sequentially. 


This topic will deal specifically with the CCW building routines within 
the module, the interface requirements between the problem program and 
LIOcCS, and the problem programmer's responsibility in utilizing this 
file management systea. 


OBJECTIVE 


Upon completion of this topic, using the available documentation, you 
should be able to: 


1. Locate and correct any errors in a program caused by an incorrectly 
coded or generated DAMOD or DTFDA.. 
2e Locate, in the PLM, the correct chart to build a ccwW string for 
- any given DTFDA declarative macro. | 
3. Select from a list of statements the correct use for the follow- 
ing macros. 


ae WAITF 
b. READ 
Ce WRITE 


4. Locate the following when given a listing of a DTFDA. 
ae Test byte 
b. First seek CCW address 
Ce CCW character strings 
d. Basis CCWs 
e. CCW build area 
f. Error byte address 
om Control CCB 
5. Determine when the data in record zero of any track is altered. 
6. Differentiate between a WRITE AFTER and WRITE ID operation. 
TV Determine the failure that occurred when given the contents of 
the error status byte. 
8. Identify from a list of statements the correct operation for a. 
WRITE ID. 
9. Locate and interpret the track reference field, using a program 
listing and dump. 


Highlights 

@ Record reference may be either by KEY or ID. 

e The logic module will build the appropriate CCW chain every time 
it is entered to perform a read/write function. 

e All data records are considered to be unblocked. 

e The problem program must supply a ten byte track reference field 
(TRF) for every read/write request to the file. 

e The problem program must check every TRF before issuing a read/ 
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write to the file to ensure that the TRF specified is within the 
given extents for the file. 


"Troubleshoot ing Hints 
e The test byte is not reset until completion of the WAITF macro. 


Therefore, it can be extremely useful in determining the function 
that the module was attempting to perform at the time of the 
failure. 

e The LIOCS - Volume 3 PLM contains charts which indicate every 
possible test byte, vector string and resulting CCW chain for 
every macro that can be issued to a DAMOD. 


Activity 


Ins: 
Under: 
Read: 
Under: 
Read: 
Under: 
Reviews 


In: 
Under: 
Read: 


Ins 
Under: 
Review: 
Under: 
Reviews 


In: 
Under: 
Read: 


LIOCS PLM - Volume 3 

Direct Access Files 

From Direct Access Method through DTFDA Macro 
Referencing Methods 

From Track Reference to Control Field - spanned Records 
Channel Program Builder 

Descriptor Byte, Builder strings and the DAM 

Channel Program Charts 


DOS/VS Systems Management SRL 

Direct Access Method 

From Device and Record Format to Indexed Sequential Access 
Method 


DOS/VS Supervisor and I/0 Macros SRL 

Declarative Macros 

DTFDA Macro and DAMOD Macro 

Imperative Macros 

Operation and Fields of the Read, Write, WAITF and Control 
Macros 


DOS/VS Base SCM 3 
Direct Access Files. 
Entire Section 


SELF-EVALUATION QUESTIONS 


1. (True/False) 


All volumes of a DA file must be online for any 


processing function. 


: 2e What is the second CCB in a DTFDA used for ? 


<> ene cee Ces Ge eee en eee eee Gn eee 
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3. 


56 


6. 


When a WRITE AFTER is issued, fields | and _ 


When is the logical unit inserted into the CCBs of a DTFDA? 


How does the DAMOD determine what CCW string to build? 


Match the macros in the left column with the appropriate statements 
in the right column. 


ae READ | 4 Must be issued after any read 
b. WAITF | or write. 
Ce WRITE 26 To return control from the user 


back to LIOCS 
3. Causes data to be transferred 
to a DASD device. _ 
&. Causes data to be transferred 
from a DASD device. 


How many bytes (decimal) displacement into the DTFDA are the 
following: 


ae Macro switch | 
be Error status 

Ce Control CCW 

d. Control seek CCB 
e. CCW build area 


of record zero (capacity record) are updated. | 


What are the descriptor bytes that will be generated for read key 
operation with the following conditions: __ __ 
SRCHM=YES 

RECFORM=FIXUNB 

IDLOC=YES 


Match the items in the left column with the appropriate statements 
in the right column. (Multiple answers are possible.) 


ae _____. WRITE RZERO 1. Writes record zero and erases 
b. WRITE AFTER the remainder of the track. 
Qe Alters record zero. 


3. Writes a record in the first 
| available space on the track. 
4. Erases the track and then 
writes a record after record 
zero. 
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10. The error status bytes contain xX'0800'. What failure occurred? 


been metteennal 


11. Why would a programmer issue a WRITE AFTER,EOF macro? 


ESE LITLE LITT NLD CEES TOLL EMS ELLE: LLLP LE LTD LED ED 


ES EAS ED CED IEP RED LLY LP TP CATED LI LP LLN ALL CLS GP LEO LT ILS LE LED ELIE TLS LD LLY LR SLT AIT LAY REED LED 


12. What is the randomizer routine used for? 


SAEED LD EI LP ATED LLL LETT OSES ET EEL? IEE ELD NI ECE LD CATED GLE 


13. The __. utility program must be used to format a 
disk pack on which DA files will be written using the WRITE ID 
macro. 


14. Put the following items in the correct sequence for a WRITE ID 
_ operation. | 


Ae ._ Verify that the seek address is within the extent limits. 

b. _ Randomize to the disk record address. 

Ce _ Write the record. 

d. Move disk record address into the track reference field 
(seek address). 

e. _. Check file for a duplicate record. 

£6 Format disk using the clear disk utility. 


15. Is the following sample of a track reference field valid for 
a 2314? 


CATE CED FI CSET ETT 


Sample: 00 01 00 AA 00 00 09 


16. What is wrong with it, if anything? 


SE ED RS ED IE ED ED AES EE ER ITED ERE ED ATED 


EERE ELIE LIED: PELL LETS LE LEMS LLL LEI LL: CELE EDEL LED LET 


SES ED GP EP GES E> Gwe ay 


Refer to the Contents for the location of the self-evaluation 
question answers. . 
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DIRECT ACCESS FILE LABELS 


When files of data records are stored on disk packs or cells, those 
packs or cells must be identified (labeled) for future reference to 
the data. Internal labels, written directly on the disk or cell it- 
self, can be read in the same way as data records - by the computer. 
This is a form of file protection. 


OBJECTIVE 


Upon completion of this topic, using the available documentation, you 
should be able to: 


1. Locate and correct any errors in label set cards when a label error 
message is printed by the systen. 

2 Identify when to use and the purpose for the XTNTXIT operand of the 
DTFDA macro. 

36 Interpret the format of the parameters passed at XTNTXIT time. 


Highlights 

e For a multivolume DA file, all extents are opened before any data 
records are processed. 

e For a DA file, the maximum number of EXTENT cards is 15 if user 
standard labels are specified, and 16 if they are not. 

@ The LBLTYP card must be used. 

e Before loading a DA file, the disk data area must be formatted. (RO) 

Activity 

Ins: Supervisor and I/O Macros 

Under: DTFDA Coding 

Read: XTNTXIT = Parameter 

Under: Concepts of DAM 

Read: Reference Methods 

In: DOS/VS System Control Statements 

Under: Job Control Statement and Commands 


Review: EXTENT Statement 


In: DOS/VS LIOCS Volume 3 
Under: Direct Access Files 
Read: Direct Access Method through DAM Logic Module Macros 
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©} SELF-EVALUATION QUESTIONS 


1. When is the XTNTXIT operand required in a DTFDA macro? 


CARD LED ETRE LEAD LEO EE LED ELLEN END LIND 


CS CLOTTED SEY CIS CETTE SEIS PE NGI TELLS CORE? CED OLD ELE ID 


2 What is wrong with the following label set for a 2314 DA file? 


EN PEE OE EELS LE LI ALE AT EY NL ISLS ED LEED LE ED LITE EELS ENTS LENS CLS ELE GLIAL LLG LIAS SILI CLES TELL CELE CLELED LE EELS TLL ETE ANE SIE TLD EELS LET LIED 


SLES EY LE A OLE ALLELE IY IO ED 


// DLUBL DISK,'FILIE FCR LOAD OR ALL DIRECT ACCESS'*', 75/365, DA 


// EXTENT SYSOOG, 111111, 1,1,3400, 100 
// EXTENT SYS006,111111,1,2,3600,1C0 


36 (True/False) For a multivolume DA file, all volumes are opened 
simultaneously. 


4. Refer to question 2. 


What does the information 3400,100 in the first extent card mean? 


a a aay 


5. Refer to question 2 extents. 
| Could a type code of 8 be used in these extents? 
@ 6. What does the following message mean? _ ae ae eae 


YO44A OVERLAP ON UNEXPRD FILE IJSYSRS SYSRES=191 111111 


7. What should you do when this message is issued by the system? 


PLP PRP LOOP LP ILD LT TD LEE STD LID ER, ATG LD LIED LE LES DALI ELT CONEY LLL ID LIED LEED LTE EAD TEED GLI LL LE LLY LES LD TTY LES NE LLY ELS ELLE LETTS LL LT LID ETE LY GES LEMS LES LEAD CELI ED TAD TG ALTOS ELLY LED SS TED SOT TERS 


8. How does a problem programmer determine the area on disk to be 
formatted with the WRITE RZERO macro for a program using the 
WRITE AFTER function? 


Ee ORD A ST SY A DS PRS SD RO SY AS NS TD A SP I TS iS TS A TL LS NS AD 


9. Refer to question 2 (the first extent only). Assume 2314 file. 


What would be the actual information passed to the problem programmer 
at XTNTXIT time (14 bytes)? _ pate . ae 
Refer to the Contents for the location of the self-evaluation 

question answers. 
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IN SEQUENTIAL FILE CONCEPTS : | : 


The indexed sequential file management system (ISFMS) permits processing 
DASD records in both random and/or sequential order by control information. | 
This data management system is very popular and is used by the majority 

of DOS/VS users. | 


This topic will present the concepts of this management system with 
emphasis placed on file organization and index construction. 


OBJECTIVE 


Upon completion of this topic, using the available documentation, you 
should be able to: 


Ts Identify the function of the following items used for processing 
index sequential files. 


ae Master index 

b. Cylinder index 

Ge Track index 

d. Cylinder overflow control record (COCR) 
e. Cylinder overflow area 

f. Independent overflow area 


de Sequence link field 
2 Identify the correct sequence and data manipulation necessary to 
add records to: 
a. Prime data area 
b. Cylinder overflow area & 
Ce Independent overflow area 
3. . Identify the requirements necessary to do the following functions; 
Qe Load 


b. Add 
Ce Retrieve 
d. Add retrieve 


e. Extend 


Activity 

In: DOS/VS Supervisor and I/O Macros SRL 
Under: Concepts of ISAM 

Read: Up to Declarative Macros 

In: -LIocs - Volume 3 PLM 

Under: Indexed Sequential Access Method 
Read: Up to DTFIS Macros 

In: DOS/VS Data Management Guide SRL 
Under: Indexed Sequential Access Method 
Read: Through Reorganizing an ISAM File 
In: DOS/VS SCM 3 

Under: Index Sequential Access Method 
Read: Up to Troubleshooting Hints 
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SELF-EVALUATION QUESTIONS 


1. Match the following terms to the correct function described. 


ae Master index 
b. _._._.. ~Cylinder index 
Ce Track index 

d. COCR 


e. Cylinder overflow 
fi. Independent overflow 
Sequence link field 


1. Each entry contains the highest record key associated with 
the cylinder, and the address of the track index for that 
cylinder. 

2. Each entry specifies one track of the cylinder index. 

36 Contains records displaced from tracks on one given cylinder. 

4. Contains a normal and overflow entry for each track on a 
cylinder. 

5. Contains the address of the last overflow entry written in 

| the cylinder overflow area. 

6. Contains the disk address of the record with the next highest 
key in the overflow area. 

7. Can contain overflow records from any track, cylinder, etc. 


Use figure 1 to answer questions 2 through 6. 


2. # What is the content of the normal entry in eRe track index for 
track one? 


KEY= DATA= 


LS SPS TD 


3. Why does record four of the track index contain a key of 150? 


PARTE GD EAS OAT 


<SRELOLTLS OTITIS STR ATE LIE EPIL TY IEG ALLE LOTITO EAE ARE LE PELE LED PIERS 


4. Why does the data portion of record four of the track index contain 
the address of track 8 record 3? 


ES EN ED A ED EAD ER END EATS ED ENS AD EY LY NED NT CANE ES EY NY EY SD AE ED LEA OD ED LD SND 
FEE IE PDL MEP CLL LENS ELD LILIES ED SLY LL OD CETTE TONS ED CD LD: SOT CLE CL LETTS ELLE STE IED LD LLY OTA LETC TD LDL LLY ETS AY CTT ODS LEO LE ELD CLE LL LLL LED CTE ITY EAE LEE EID SEE LEITE LESAGE OLE RIEL LEI LE TELLTALE LEED 


LEAD SEP ASAD CESS CENT AAS CREEL IIS SLD LP SELLS ET LIT IS LES ERS ND A CL RS A AMS EP EIS RD NO EY EY CE SLY FEES AD LP EY LD EE ES EID NE CT etre NY EY A CTS ES SEE ED EE GES SEY OER CRRA CSR ARE ORD ITD 
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5. 


me ae Track 8 


A record with a key of 235 is added to the file shown. Which areas 


of the file will be changed and if changed, what will the area 
contain? | 


ae Master index 


AE CETUS EET ALS ED ED ET TEED WE ETD DAR IL PORE ELOY SSIES SEEING SLY ALY LATTES SETED CEE AAD ELEY LETT) BL EIN LED LTEEIS LIE ED SLITS LI IEE 


b. Cylinder index 


ETD ALLY CEILI CLG CLD ETE) GEELD LIE LD LILY CELL, COLE LEY CDETET ELTT! LL DELLRELLLLD ELS LELLES ELLE OLEEE LS EBERLE TS LETTE ELLE LEDS EBEED DILLEY ELE ELLERY LILLIE G ERGY CLT N LE CIOELEY EDEL ES CLERGY LADS PLDI 


Cs. Track index 


ED LED RAPED CS AGE SED CLEP CEP SEED OTT CASED EE) GED GES CEPA GE ERE? GENS GP CERES qe cE CED GES CC EEE GARD ES CR EEG CER EE? EE CRED GED TED 


d. Track 1 


e. Track 2 


CEL SEED ORS IEP TIDES LP DOIG LG CPLR ETS EE: EIS LELD LED EEO LMT LES BEY LLP SILLY SELL LE LED LOPLI OLED EEE OECD SEP AEA IEE ATES LED ELEY ELIS ELS EGE LEED GELS LILI TOES CEE EEL LEED 


ge COCR 


If a record with a key of 90,000 was added to this file, which 
index(es) will be altered? 


baad 


What three requirements are necessary for the input data used to 
load an IS file? 


EDEN CREATORS RESID CHES COR CRN CGE CEE EES CEES GED GIP GED EEIS AMPH GED SP CRY ERD CEP EES ED STS ENP AP GPSS GR CREP SR EEE CEP CM OEE GED GR PP eS WES REED CERP EELS ASE) cE EP ALS EP SO? 
e 


EP LIED SEED ELE ED EP ACES PELE AD aD 


What is the difference between a LOAD and EXTEND on an IS file? 


CIE CLE ALLE: SET LE | 


ERED IY OED ATID ES ED ES AP LD RS CP EEIS Ee SS EEE ED PTE ENS aE ESD) EPP CESS GIEP AAR IEP, EE SS ED SED CAPD SEP GES GS GP ES EA EP 


ID EE ES AED OTE AOS A ED CY PD CS AM SEES ATF SS SY AO ED ES ED APE CP OED AS SEEPS EE EEE oa AREER POE CRT OSE ED GOD CSTR PUD GRATER LI SID GREP EE 


ESRD AIRSET AENEID IIE TLE SID ELS LESTE SLD CEIVED PES AY ALY LLAED LL SATE CLE EAN IIS ELI SEE AG LEELA ESD ENG BNE) LAGE CELE LENE ELLY ESTEE EE IPE LEE ARIEL LLLP LG LLY ALDI LLELY ELE LEED 


Records with keys higher than highest on file will be added to 
the prime data area until __ Eee eee ee 
i os ihe hom and then’ the records will be 
added to the appropriate overflow areas. | 


Refer to the Contents for the location of the self-evaluation 
question answers. 
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Track Index ee ae Ro ake PM eens em Pree ar ee ~~ Data Records 
| Track 8 H jTrack 8 ~ 
Track 0 bane tne at a sien 150} Record 3 te = Track 2 | Ai aa at umm | Pst owe | 
\ H 
'D D D K D K D 
au awe 
{ i 
K D K D K D K D 
Data Records 
t ’ ] 
.« D K D KD K D 
: 
” Date Records 
' 
Data 975! Data 
D K D 


CD cee eee meme eR a mete meme cee come come meee meee ae my ee ce me SE TD See me Sm ee ne Se ee SED GE Ge OE SE NY RD SE SE cD Gm ED SR OY CORR OY ee oo owe Oe oe pee © 


Overflow L Data Records 


i] 
160| SLi + Data 
5! 1140} 


Track 8 


K D K D K D K —D 


ss Data Records 


Master Index = : 
j Track I 1 Track 1 m ; ‘Track | AH, 
Track X | X+1 TR 1 xX+2 1 3, | X+20 | 11 Dummy 
Address 0! Address ! lot Address | Bits! 
ra D K D K D K D 
Cylinder index 
Cylinder 1 Cylinder 2 ! i%, 1 Cylinder 10 
eg : 980! Track 0 8 TrackO | 13 | Track 0 
Address 0; Address ! | “go! Address 
K D K K D 
Cylinder 11 vlinder zy s Cylinder 20 
Track 8 ' TrackO | 9 | Track 0 .. \ Track 0 
X+2] 9! address | O! Address ‘0! Address 
K D K D K D 
° 
r 
e 
1 Cylinder 150 Cylinder 151, Cylinder 160 1 All ' 
Uae 9 | ' Track O iy Track 0 ! | | Track O 11 Dummy 
X +20] “ty address | Address : - | Address (Bite! 
K D K dD 
K = Key Area 
D = Data Area 
SL = Sequence Link 


*SL indicates the end of the overflow chain. 
COCR = Cylinder Overflow Control 
Record (Contained in RO) 


IFE 104947] 


Figure 1 - ISAM File Example 
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INDEX SEQUENTIAL IMPLEMENTATION 


This topic will cover the MACRO coding necessary to use an ISFMS. Also 
covered will be the labels necessary to define the areas on disk. 


OBJECTIVE 


Upon completion of this topic, using the available documentation, you 
should be able tos; 


1. Identify and correct any errors in label set cards used for IS files. 
2 Identify and correct any errors in coding or expansion of IS MACROS. 
3 Identify and correct failures indicated by the status or condition 
code byte (FILENAMEC) while using IS files. 
4. Identify the MACROS needed to. do the following functions. 
Ae Load or extend file 
b. Adding records 
Cx Random retrieval 
d. Sequential retrieval 
5.0 Identify any entry in a DTFIS that is created from the labels in 
vToc for any input file. 
Activity 
In: DOS/VS SCM 3 
Under: Index Sequential 
Read: Troubleshooting Hints | 
Ins DOS/VS System Management Guide SRL 
Under: Indexed Sequential Access Method 
Reads From Indexes to Storage Space Formulas 
In: DOS/VS Supervisor and I/0 Macros 
Under: Concepts of ISAM 
Read: Up to Declarative Macros 
Under: Declarative Macros 
Reference; DTFIS and ISMOD 
Under: Imperative Macros 
Read: SETFL 
| ENDFL 
WRITE 
WAITF 
SETL 
ESETL 
Ins DOS/VS DASD Labels 
Under: Types of Labels 
Read: Format 2 Label 
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Ins 


LIOCS - Volume 3 


Under: §§ Indexed Sequential Access Method 


Read: 


Overflow Areas 

Indexes 

Functions Performed by ISAM 
e Loading 

e Adding 

@ Retrieving 


SELF-EVALUATION QUESTIONS 


1. 


Se 


What three parameters in the DTFIS are required to implement | core 
indexes? | 


> AD TD AP A TT 


(True/False) The master and cylinder indexes can be in core for 
ADD and SEQRTVL only. 


While loading an IS file, the input data is out of sequence. What 
would the status or condition code byte contain? x 
The following instructions are being used to create an IS file. 
End-of-file on the card reader will cause a branch to STOP. 
Assume all DTF parameters and record formats are correct. 


OPEN CARD 
SETFL ISFILE 
OVER GET CARD 
WRITE ISFILE, NEWKEY 
WAITF ISFILE 
STOP ENDFL. ISFILE 
CLOSE CARD, ISFILE 


The macros will not accomplish the desired functions because 


AT AL A TEP TD De GD ED | TS AS CS NS ee i a aS SS ae ae a a <a ae 


a 


To sequentially update an IS file which of the following macros 
are not used? 


ae READ 
be SETL 
Ce GET 
d. WRITE 
eC. PUT 
f. ESETL 
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6. 


Select the correct sequence of the following macros needed to 
randomly update a record in an IS file. 


ae _— 1. WAITF ISFILE 

b. Ree eee 2 READ ISPILE, KEY 

Cs | ois 3 WRITE ISFILE, KEY 

d. 4. WRITE ISFILE,NEWKEY © 

e. eree eke ae READ ISFILE, NEWKEY | 
6. Internal manipulation of record (update) 


Write the macro to initiate sequential processing of an IS file 
at the beginning of the file. _ | 


In a format 2 label, bytes contain the address of the 
last record written in the independent overflow area. 


On an IS file used as input, the location of the key in the record 
is inserted into the DTF from bytes ___ of the format __ 
label at time. 
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10. 


11. 


Write the DLBLs and EXTENTs for an IS file created with the 
following characteristics: Assume 2314 file. 


CYLINDER 50 ——— 
CYLINDER 51 


CYLINDER 57 
CYLINDER 150 ——— 


LEGEND: 


DTFIS name is ISBUILD 
File ID should be "PAYROLLO1' 
(Assume all extents start on head 0 and end on head 19.) 


, CYLINDER 58» 
CYLINDER 59 
CYLINDER 130 


VOL S/N = 000001 VOL S/N = 000002 VOL S/N = 000003 


MI = Master Index 

Cl = Cylinder Index 

PD = Prime Data 

10 = Independent Overflow 


SPD ROLE CLD CAEP EEN (APES SEIT OS ATES CTY ATS TIAD CED SED ST GPCRS? CHEE ERED SLD GERD GUETP OFED CUED GE GPCR EDO CAND CAD AED CESS CTD MENS GD O-PS AE PEEP a CE CD GEER aS 


ED EE EEE CAD AD ED LAD ED GS AED PAIS GID AEE CO EP EP SD aT AD CNTO GD EES A ED EE RD EN ND CE EN A A LD SEN AED PES 


(True/False) The file described in question 10 could be extended 


at a 


later date if desired. 


Refer to the Contents for the location of the self-evaluation 
question answers. 
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INDEX SEQUENTIAL INTERNALS @ 


This topic covers the internal operation of ISFMS. Included will be 
the CCW Build function, format of the indexes and sequence link field 
and a work project to let the student interpret the disk data layout. 
This exercise will tie together the interaction of the indexes with 
relation to prime data and overflow Eceorss in both the cylinder and 
independent overflow areas. 


OBJECTIVE 


Upon completion of this topic, using the available documentation, you 
should be able to: 


1. Determine if the following areas have been created correctly when 
given a disk printout. 
ae Master index 
b. Cylinder index 
iC Track index 
d. Sequence link field | 
2.0 Use the indexes and sequence link fields to locate a record in any 
of the following areas when oven a disk printout of an IS file. 
Ae Prime data 
b. Cylinder overflow 
c. Independent overflow 
3. Use the label set to locate the following in a printout of an IS 


file. 
ae Master index | = 


b. Cylinder index 
Ce Prime data 
d. Independent overflow 

4. Determine how the M table is generated and what information it 
contains. 

56 Use the CCW build constants in the ISMOD to determine if a CCW 
string has been built correctly or use the CCW string to determine 
if the CCW build constants are correct. 

6. Identify, using the PLM, correct operation for an OPEN or any 
imperative macro for an IS file. 


® Refer to DOS/VS SCM 3 under Indexed Sequential Access Method 


Activity 


In; DOS/VS*.LIOCS ~- Volume 3 

Under: ISAS 

Read: From Record Types through Sequential Record Retrieval 
Under: DTFIS Macro | 
Scan: Fields of the Macro 

Under: ISAM Initialization and Termination Procedures 
Read: Through the ISAM Open Chart 

In: DOS/VS Supervisor and I/0 Macros SRL 

Under: Concepts of ISAM 

Read: Entire Section 

Under: Declarative Macros 

Read: DTFIS Macro and Operands 

In: DOS/VS Data Management Guide 

Under: Indexed Sequential Access Method 

Read: From Indexes to ISAM space Formulas 

In: DOS/VS SCM 3 

Under: Indexed Sequential 

Refer: 


Troubleshooting Hints on register usage 


SELF-EVALUATION QUESTIONS 


6 " 


2< The entry in the M table containing the cylinder index information 


time while creating 


The format 2 lahel is created during. 
an IS file. | 


is: 
ae First. 
b. Second. 


Cw Third. 


3.0 A record will be written (ADDed) to the IS file by which of the 
following? 


Ae WRITE FILENAME,NEWKEY 

Cc. WAITF 

d. READ FILENAME, NEWKEY 

Ce OPEN FILENAME 

Use the FoLsOwrng information to answer questions 4 and 5. 


Given a CCW builder control code of 1333 to do an ADD function to 
an IS file. 


4. What is the resulting CCW command code? X's‘ S 


5. At what label can the I/O area address be found? 
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6. 


11. 


12. 


Register | contains the address of the list of CCW 


ad A SD SD 


builder control codes when in the CCW builder routine. 


Match the following digits of the CCW builder control code to 
the CCW fields built. 


1 3 3 3 


ae CCW OPCODE | a | 
b. T/O AREA 2. 


Cs FLAGS 3. 


TELE EL LED RITE 


d. _ COUNT | 4. 


Given a DTFIS with the name ISBUILD, at what label will the DSKXTN 
table (M table) be found? 


Ey CER CA EE SE ERED EE a IPE CES LS CES RM ID ID SD SSD CY CED LY CNG SY LL I SEP LEED SE 


What indicates the end of the DSKXTN table (M table)? _ 


If the ERREXT option is specified for a DTFIS and an unrecoverable 
I/O error occurs, register 1 plus a displacement of 
(DEC) will give the failing CCW op code. 


(True/False) User standard labels for ISAM can only be created 
at OPEN time. 


What functions do $$BOISO9 and $$BOIS10 perform? 


SUES STD ED CCE CN AED AY ON A IE PD EN ARE RAEN CETTE STS AP AEE SAE MED ETN RP AGED ATED AY RA CLES ELS LS TE NS DAS ELL ESE CGY LEER LY TS AL: TATE LEGS LILIES ELEM LES ET I LETT 


, 
ME CEOUED CED CARAT AEP TED GATES SEIS ATES EBS GED EA AOE RTD OP a ED ES RR GE AS IED PP ED CEES PUY a AS ED ES AE ED RD EE <TD ae PTE PEED EE ED CEE ETE ED GRE ES CPP atin SAY CE HEY CLD ED 


Refer to the Contents for the location of the self-evaluation 
question answers. 
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DISK WORK AND VICE INDEPENDENT FI FILES 


A work file is a single volume file that can be used for both input and 
output, even within a single program phase. It is often used to pass 
intermediate results between successive phases or job steps. However, 
work files, also can be written, read, and rewritten within a single 
phase without requiring additional OPEN and CLOSE processing. 


Device independent files are implemented by utilizing the DTFDI and 
DIMOD macros. The problem programmer can achieve device independence 
for system files. For example, when the device-independent macros 
are used in the program, at execution time the system unit SYSLST 
could be assigned to a printer, tape drive, or disk extent. This 

can be particularly advantageous to the problem programmer in a 
multiprogramming environment since a specific physical device may 

be in use by another partition. By the use of an assign statement, 
the desired program can ‘still be run. 


OBJECTIVE 


Upon completion of this topic, using the available documentation, you 
should be able to: | 


Vs Select from a list of statements the correct use for the follow- 
| ing macros. 
ae CHECK 
b. NOTE 
Ce POINTR 
d. POINTW 
Ce POINTS 
2» Use the appropriate detail flowcharts in the PLM to locate logic 
or coding errors in the DTFDI or DIMOD macro. 


Highlights 

Disk Work Files 

® Work files process fixed-length unblocked records and 
undefined-format records only. 

@ Disk work files are always opened as output files. 


Device Independence | 

Only fixed unblocked records are supported. 

Combined file is not supported. 

User labels are not supported. 

Rewind options and reading backward are not supported. 

Device independence is limited to card readers, card punches, 
magnetic tape units, DASD and Diskette. 
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In: Supervisor and I/O Macros SRL 

Under: Sequential Access Method 

Read: © From DTFDI Macro through DIMOD Macro 
Under: Imperative Macros (Sequential Disk) 
Read: From Work File Macros for Tape and Disk to Completion Macros 
In; LIOCS - Volume 2 

Under: DIMOD Macro 

Read: | GET and PUT Macro Unit 1 and 2 I/0 Areas 
In; DOS/VS Data Management Guide SRL 

Under: Device Independence 

Read: All information under this heading 


SELF-EVALUATION QUESTIONS 


1. (True/False) Only system logical units may be specified with a 
device independent file. 


2e (True/False) Within the execution of the first GET/PUT request, 
the module will determine the physical device type and will modify 
the DTFDI accordingly. 


3. Match the statements in the right hand column with the appropriate 


macro in the left hand column. & 
- _ POINTR 1. Prevents user processing until completion 
of the input/output operation. 
_ POINTW s. ei Returns to register 1 the address of the 
record just written or read. 
=e _ NOTE 3. Used to reposition the file to read the 
7 record that was just read or written. 
_ POINTS 4. Used to reposition the file to write at 
the record location that was just read 
or written. @ 
___.__. CHECK 5. Used to reposition the file to the 


beginning of the first extent. 


4. 


Se 


6. 


List the eight restrictions of DTFDI processing. 


. - oe . \ an 


If the problem programmer wishes to retain the format 1 label of 
a disk work file, in the VTOC, what operand(s) in the DTFSD must 
be specified? 


TD ED AD CS A A ADA ee a 


' : 


ED ED Ge Een EES qnee qlee qiame TENE GEE aD 


AD A OR AS NS ES ND SP SP CPE STAD Clie NN? OP TN RD ANTE UD PNAS END CE SO ED CED EP 


. 


 emmehonmmed 


The detail flowchart in the PLM that contains the logic for the 
GET macro for a DTIFDI file (one I/O area) is on chart ° 


When using the DTFDI and DIMOD to process input records, 
ERROPT=OMITTED and WLRERR=OMITTED in DTF, and a wrong length 
record occurs, the message issued by the system will be ° 


</:e 0D GREG anen GP qa eae 


Refer to the Contents for the location of the self-evaluation 
question answers. | 
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CHECKPOINT/RESTART 


Checkpointing is a means of recording the ‘status of a program at desired 
intervals. Restart is a means of restarting the execution of a progran 
from one of the previously checked points, rather than from the beginning, 
if processing is terminated for any reason before the normal end of 
program. For example, a job of higher priority may require immediate 
processing, or some malfunction such as a power failure may occur and 
cause an interruption. The checkpoint ability is provided through the 
CHKPT macro while the restart ability is provided PErouse a job control 
statement (RSTRT). 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Identify the various types of checkpoint records that are written 
on tape or disk. 

2. Identify erroneous usage of the CHKPT macro. 

3. Determine what the contents of a specified field should contain in 
any given a da record. 


Highlights 


® Checkpoint records can be written onto disk or tape. 

e Checkpoint records on disk require user routines to open the disk 
area that will be used. 

@ If checkpoint records are interspersed between normal data records 
on tape, the user's responsibility increases. 

e Checkpoints can be taken by any program. 

eo Restarting of checkpointed programs is accomplished by use of a 


job control statement and the job control restart progran. 


Activity 
IN: DOS/SVS Base SCM 1 
READ: The Checkpoint/Restart Section 


and answer the Study Questions 


SELF-EVALUATION QUESTIONS 


1. (True/False) Checkpoint records can be stored on a device other 
than disk or tape. | 


2s The operand of the CHKPT macro designates the point at 


i CE qe ela CEE? CEE ATE aS a 


which restarting takes place. 
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8. 


10. 


Select from the list below those items which are saved as a result 
of a checkpoint. | 


a. Floating point registers 

b. General registers 

Co Timer values from the SETIME macro 

d. Portions of the communications region - 


What is the meaning of nnnn in the following job control statement? 


// RSTRT SYSxxx,nnnn, filename 


nap oe 


Under what conditions is CHKPT ignored? 


ae The device on which the checkpoint records are to be written 
is a magnetic tape. 

Da The area on disk is not large enowat for two checkpoints. 

c. The CHKPT macro is issued before the disk checkpoint file is 
opened. 


(True/False) The job name specified in the JOB statement for RSTRT 


must be identical to the job name used when the checkpoint was taken. 


From which of the following does the programmer obtain the number 
of the last checkpoint taken? 


Ae From the number of DATA cards read. 

b. From the output on SYSLST. 

Cs From the output on SYSLOG. 

d. From a DASD dump of the checkpoint records. 


(frue/False) Restarting can be done from any checkpoint record, 
not just the last. 


A disk checkpoint header record can be identified by which of the 
following: 


ae /// CHKPT // in bytes 0 to 11 of the record. 
b. PFIX in bytes 0 to 3 of the record. 

Ce ///CHKPT// in bytes 0 to 9 of the record. 
d. ///CHKPT in bytes 0 to 7 of the record. 

e. /// CHKPT in bytes 0 to 9 of the record. 

f. None of the above 


(True/False) When a checkpoint is taken by a CHKPT macro in which 
the fifth and sixth operands are specified, the general registers 
are saved in bytes 4 to 67 (decimal) of the second checkpoint record 
written on the checkpoint device. 
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11. 
12. 


13. 


TH. 


(True/False) PFIX checkpoint records are not written during a 
checkpoint if bit 0 of the 13th byte in a /// CHKPT // record is 0. 


(True/PFalse) When the sixth operand in a CHKPT macro is specified, 
the fifth operand must be specified. 


Issuance of message OCO4IT would indicate the improper usage of 
which of the following: 


Ae DTFPH macro 


b. ASSGN statement 
Cc. CHKPT macro 

d. RSTRT statement 
CQ JOB statement 


The first four bytes in a checkpoint record contain X*E7E3D510°. 
Select the most appropriate statement based on the given information. 


Ae A checkpoint has been taken on tape and the problen progres 
was using 2314 and/or 2311 DASD for I/o. 
de A checkpoint has been taken on disk and the problen program 
: was using non-file protected 3330 DASD for I/o. | 
Cc. A checkpoint has been taken on either tape or disk and the 
problem program was using file protected 3340 DASD for I/0. 


™ 


Refer to the Contents for the location of the self-evaluation question 
answers. : 
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SAFETY PRECAUTIONS AND HOUSEKEEPING 

Refer to your CE Safety Practices card (Form S229-1264) for 
general safety precautions. Additional instructions on safety 
and housekeeping procedures will be supplied to you by your 
instructor. | | 
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LAB PROJECT 1 - VM_FAMILIARIZATION . @ 


The VM/370 control program (CP) may be thought of as a second 
level of microprogram in addition to the one that normally con- 
trols a CPU. This microprogram accepts operator commands to 
display storage and registers, IPL, address stop, instruction 
step, etc, just as any other CPU. The intent of this project 

is to provide the student with the necessary skills to operate 
VM/370 as a typical CPU. Therefore, only the commands necessary 
to achieve that skill level will be introduced at this time. 


OBJECTIVE 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Operate the VM/370 terminal for program execution and 
debugging. | 


 Time-required to complete this project averages 1.0 hour. 


Tools, Test Equipment and Documentation 


VM/370 Terminal and Reader 
System/370 Principles of Operation | 
Console Familiarization Deck - Lab Copy © 


Directions 

This project is intended to familiarize the student with 

VM/370 Operation if he has not been trained on it. All students 
will read this project. PART 1 will be answering the study 
questions, using Figure 1. Students then are to read PART 2. 
Obtain a system and follow instructions in PART 2. Consult your 
lab instructor when ready to begin PART 2. 


PART 1 


1. The instruction at F70 (Subtract Register) is used to zero 
register 5. What is the instruction at F72 accomplishing? 


(Ube arene ERED en Ee nee GED CREED auEP Ee cn eee EN PRED CURED GER ND A CRD ED COP ES A RG AY EE AY APN CE LS LS PD LY AY LY OD EP SE aD 


2s The load address instruction at F78 is used to increment the 
register. How is this accomplished? 


3. Under what conditions will a branch occur with the instruction 
at FVE? 


LPL OTD 


4. How many positions of core are reserved by the DS statement 
that follows the LPSW instruction? 


ate wih ae ep ea 


5 When the LPSW instruction is executed, does the program 
branch to address 001234? | 


Answers 
1. This instruction is also used to zero a register. Both 
methods are commonly used in programming. | 


by the second operand into the specified register. This 
differs from the LOAD instruction in that the LOAD instruc- 
tion loads the contents of core at the address specified. An 
example of this would be: Suppose register 5 contained the 
value of 10. If that register is used for a base register 
and a displacement of 1 is also indicated, the combined 

value would indicate address 11. Using the same register as 
a base register and the register to be loaded, this instruc- 
tion can be used to increment a counter by any value speci- 
fied in the displacement. 


2. The LOAD ADDRESS instruction loads the address specified 


36 Specifically, the instruction is testing for and will branch 
on a compare low or a compare high condition. What the 
programmer is looking for is a branch on any not equal 
condition. 


4. This use of a DS statement doesn't reserve any core per se. 
It is used for boundary alignment for the following constant. 


5. The program doesn't branch but causes the machine to enter 
WAIT state. 
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LAC 
OOOF70 


OOOFTO 
QOOF 72 
QOOOFT74 
OOOF 78 
OOOFTC 
OOOFTE 
OOOF 82 
OOOF88 
OOOF88 
OOOF90 


QOBJECT CONE  £ADODRIL 


1855 

1766 

5860 OF90 

4155 0001 

1956 

4770 OF78 

8209 OF88 OOF 88 


7F020000000012 34% 
00070000 


LAB PROJECT 1 - Figure 1 


ADDR 2 
OOF70 
OOF90 


00001 


OOFT8 


OOF 70 


STMT 


ODNONF WNP 
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SOURCE STATEMENT 


BEGIN 


Loop 


PSW 
CON 


START X*FT70° 


USING *,0 

SR 5,5 

XR 676 

L 6 »CON 

LA 5,1{5) 

CR 5,6 

BC 7T,L00P 

LPSW PSW 

DS On 

DC X* 7F02000000001234! 
DC X* 00070000! 
END 


BEGIN 


@ 


PART _2 


1. 


2s 


LOG ON - The terminal must be logged on. Your instructor will do 
this for you. He will also provide a card deck and ID card. 


PROGRAM LOAD 


Ae 


b. 


Ready the card reader with the program used for this lab 
project after placing the ID card ahead of the deck. The 
deck is immediately read from the card reader. 


The screen should display the message CP READ. If it does 
not, depress the DUP PA1 key. 


To load the program into our DOS system enter the IPL 
command. | | 


1. Key in ipl 00C (If a typing error is made, the key with 
the «—— allows you to backspace and retype). When 
the program has been loaded in its entirety, the loader 

transfers control to the program and it starts its 
execution. The program will loop for a few moments 
before it enters a wait state. 


Console Indications 


Be 


Notice that after 15 seconds or so, there has been no 
response from the console. During this period of time, the 
program first looped for a few moments and then entered the 
wait state. It is apparent then, that there is no 
observable difference between a loop and a wait state. 


A wait state results from loading a PSW which has its wait 
bit turned on. Thus, by displaying the current PSW, it may 
be determined if the system is in a wait state. | 
1. Depress the DUP PA1 key. 

26 The terminal responds with CP READ. 


a. Key in: display psw 
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4. Depress enter key | @ 
5. The terminal responds by printing the current PSW: PSW 


- 7F020000 00001234. The wait bit is, in fact, turned 
on. 


6. To return control to a program that has been stopped by 
a depression of the DUP PA1 key: 


Key ins begin 
Depress the ENTER key 


NOTE: Your program does not continue to execute while you are in 
CP READ mode. 


4. Setting the Instruction Counter 


The program will now be rerun by initializing the instruction 
counter to the address of the first instruction in the progran. 


ae If control has been returned to the program (via the begin 
command) depress the DUP PA1 key. 


The terminal responds with: CP READ 


b. Key-in: store psw 00000000 00000f70 


Cs Depress enter key. The current PSW now points at the first 
instruction (0F70) and the wait bit is off. & 
d. To verify that the program does re~execute, change the 
instruction address portion of the PSW at location OF88 from 
X*1234" to X'OFT7O*. 


1. Key-in: store O0f£88 7£020000 O0000£70 
2e Depress the enter key 


e. Return control to the program via the begin command. 


1. Key-in: begin 
2. Depress the enter key 


Es At this time, the program re-executes the loop and then re- 
enters await state. After approximately 15 seconds, again 
display the current PSW. 


Depress the DUP PA1 key 

The terminal responds: CP READ 

Key~in: display psw 

The terminal prints the current PSW: 
PSW 7F020000 O0000F70 


EWN ow 
r 8 @ 8 


The instruction address of the PSW is X'OF70', verifying that the 
program did, in fact, re-execute. 


Display and Alter Main Storage 


Ae Display the storage locations containing the PSW to. be 
loaded by the program (0F88O0FS8F) 


Is Key-in: display 0f88-0Of8f 

2. Depress the enter key 

3. The terminal prints the storage locations: 
OF88 7F020000 O0000FT7O0 


b. Alter these locations so that when they are loaded as the 
current PSW, control will be returned to the program 
beginning address (0F70) 

1. Key-in: store psw 7£000000 00000£70 

2. Depress enter key 

3. Key-in: begin 

4. Depress enter key. The program is now in an 
endless loop. 

Trace 

The trace facility is a useful tool for determining the sequence 

of instruction execution within a program. It is particularly 

useful in determining the cause of a loop. Trace a portion of 
the program which is now executing: 

ae Depress the DUP PA1 key 

b. The terminal responds: CP READ 

Ce Key~in: trace all 

d. Depress enter key 

e. The terminal responds: TRACE STARTED 

f.  Key-in: begin 

g- Depress enter key 

h. The program executes one instruction. The terminal prints 
the instruction address, the mnemonic and the actual 


instruction followed by: CP READ. 


ie To execute each successive instruction you must again key-in 
begin followed by a carriage return. 


There are other options available using trace and a 


method to take it out of instruction step mode. These will 
be discussed later in the project. | 
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Display and Alter Registers 


The program is looping through the instructions at OF78, OF7C and 
OF7E. This loop will continue until the contents of register 5 
has been incremented to equal the contents of register 6. Lets 
speed the process by first displaying register 5 and then storing 
a value of 6f000 into register 5. 


Qe Display register 5 


1. When the program has been traced to address OF7E, 
key-in: display g5 

2 Depress enter key 

3. The terminal responds: G5=xX (some value between 
0 and 70000) 


b. Alter register 5 


1. key~in: store g5 0006f000 
2- depress the enter key 


Ce Display all registers and verify that register 5 has been 
changed. 


1. Key-in: display g 

Ze Depress enter key 

3s The terminal responds by printing the contents of 
all of the general purpose registers. Note the 
contents of register 5. 


de To stop the trace: 


1. key-in: trace end 

2. Depress the enter key 

or The terminal responds: TRACE ENDED 

4. key-in: begin 

5. depress the enter key AVOip 

The program now resumes execution. 
Tracing a loop 


The program is in a 3 instruction loop. That can be determined 
with the trace function. 


ae Depress the DUP PA1 key 

be The terminal responds: CP READ 
Ce key-in: trace all run 

d. depress the enter key 


e. The terminal responds: TRACE STARTED 
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k. 


le 


key-in: begin 
depress the enter key 


The program is now running with trace active. The arrows 
indicate branches were successful. 


Submit the trace end sequence as you did in step 74d. 
Enter CP READ mode by depressing the DUP PA1 key. 


1. key-in: trace branch run 


Ze depress the enter key 
3. The terminal responds: TRACE STARTED 
4. key-in: begin 


5 depress the enter key 


This trace function displays only instructions that were 
successful branches. Our program has only one on this loop. 
It should be displayed as: 


OOOF7TE BNZ 47700F78 = OO00F78 


It indicates the BNZ instruction at  F7E branched 
successfully to F78. : 


Submit the trace end sequence as you did in step 7d. 


To break out of the loop, alter register 5 to 6ffff while at 
location OF7E. Use the trace function (without RUN) to stop 
at OF7E and use the alter register procedure. 


Continue to execute the program with trace enabled: 


1. Keyrin: begin 

26 Depress enter key 

36 Repeat steps 1 and 2 to trace execution of 
each instruction. 7 


After executing the instruction at OFT7E, the next time, the 
program breaks out of the loop. 


To stop the trace: 

1. Key-in: trace end 

2. Depress enter key 

3. The terminal responds: TRACE ENDED 
4. Key-in: begin 

Se Depress enter key 


The program now resumes execution. 
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9. 


10. 


Address Stop 


The address stop feature allows the execution of the progran 
to be stopped at a particular instruction address. Stop 
execution of the executing program just as the LPSW instruc- 
tion at OF82 is to be executed. 


NOTE: 


Depress the DUP PA1 key 


The terminal responds: CP READ 


Key-in: adstop 0f82 


Depress enter key 


Key-in: begin 
Depress enter key 


When the LPSW is encountered the terminal types: 
ADDRESS STOP AT OF82 CP READ 


To continue execution: 


1. Key-in: begin 
2. Depress enter key 


The program must be in storage before address stop is 
activated, otherwise, the system will not stop. 


IPL DOS/VS Under VM 


Ae 


b. 


Ce 


key-in: IPL 130 


depress the enter key twice, the terminal responds: 
OI03A Specify Supervisor Name 


depress enter key twice, the terminal responds: 
O©TO4IT IPL DEV=X'130', VOLS ER= 111111 

OT30L DATE=xx/xx/xx, CLOCK=xx /xx/xx 

OI10A GIVE IPL CONTROL COMMANDS 

key-in: set 

depress enter key 


key-in: dpd 


depress enter key, terminal responds: 
OI52 PAGE DATA SET EXTENT 


OI20I DOS/VS IPL COMPLETE y, 
BG 

1100A READY FOR COMMUNICATION 

BG 
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NOTES: 


11. 


When you are in VM READ you may enter a log statement. | 
Do not type in log while your terminal is in CP READ mode as 
you will be logged off the system. Use of the log statement 
in VM READ will cause Job Control statements to be displayed 
on the tube. This will enable you to determine which job 
step the CPU is processing. On an assemble, link edit, and 
execute job stream this feature is a valuable aid. To use 
this aid, key in log and depress the enter key while in VM 
READ mode. | 


Notify your instructor of your completion of this project. 
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LAB_PROJECT 2 - V4/370_ SPOOLING 


The commands which will be introduced in this project are those which 
control and monitor the spooling activities of YM/370. The intent of 
this project is to provide the students with the information necessary 
to operate DOS/VS systems under VM/370 while in the lab. Therefore, 
only those commands which are essential to achieving that level are 
introduced in this project. 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Use the query command to monitor spooled files. 

2 Use the purge command to erase spooled files. 

30 Use the close command to produce punched or printed output. 

a. Correctly code an ID card and execute a program in a 
spooled environment. 


Time required to complete this project averages 0.5 hour. 


Tools, Test Equipment and Documentation 


VM/370 Terminal, Reader and Printer 
System/370 Principles of Operation SRL 
VM/370 Spooling Familiarization Deck 


Directions 
Read the following: 


In a spooled environment, input from the reader is placed on disk 
pricr to processing. During program execution, output destined for 
the printer and punch is also first stored to an area on disk. During | 
program execution then, all unit record I/O operations are intercepted 
by the VM4/370 Control Program (CP) and rerouted to disk. [In order for 
the input from the reader to be stored in the correct disk area, an ID 
card must precede the deck. In order to obtain output on the printer 
or punch from their respective areas on disk, the CLOSE command must 
be issued by the operator. The number of existing input and output 
files for the reader punch and printer may be determined via the QUERY 
command. Files may be erased via the PURGE command. These commands, 
as with the others presented in Lab Project 1, are valid only when cP 
READ appears in the lower right corner of the console screen. 
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PART It 


Figure 1 is an assembly listing of the standalone program which will 
be executed. The program is an extension of the one executed in Lab 
Project 1. Its function is to print 3 lines on the printer. Study 
the listing in Figure 1 before executing the program on the systen. 
Perform the following steps: : 
1s Obtain the lab project deck. 
2. Log on the systen. 

a. Key-in: Log USERID PASSWORD (See note following Step 14) 

b. Depress enter 


3% Query files to determine if there is any existing input from the 
reader or output for the printer/punch. 


ae Key~-in: Query files 
b. Depress enter 


Ce The console responds by displaying the number of existing 
files. 


u. Purge the reader files 
ae Key-in:s Purge rdr 
be Depress enter 


‘Ce If any reader files had existed previously, they would now 
have been erased. | | 


5. Purge the printer files. 
ae . Key-~ins Purge prt 
b. Depress enter 


Ce If any printer files has existed previously, they now would 
have been erased. | 


6. Purge the punch files. 
Ae Key-ins Purge pun 
be Depress enter 


‘26u If any punch files had existed previously, they would now 
- have been erased. 
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8. 


10. 


11. 


Spool the project deck to the disk area associated with the 
reader for this userid. 


ae Place an ID card ahead of the deck (See note). 
b. Place deck in the reader and depress start and end of file. 


Cs Observe that the entire deck is immediately read and _ stored 
in the disk area associated with this user's reader. 


Query files to determine if the deck has truly been read into the 
user's virtual reader as was stated in 7c. 


ae Key~in: Query files 
b. Depress enter 


Ce The displayed information indicates that there is now 1 
reader file present. : 


IPL the program as a standalone. 
ae Key-in: IPL 00C 
be. Depress enter 


Cs After a few moments, the program execution is complete and 
enters a disable wait. | 


d. Note that, as yet, there has been no output to the printer. 
Query files 

Ae Key-in: Query files 

b. Depress enter 

Cu Notice that the information displayed indicates that the 


reader file no longer exists--that is to say, the cards have 
been read from the virtual reader. 


To obtain the output for the printer, the printer file must _ be 


closed by the operator. 

ae Key-in: Close prt 

b. Depress enter 

Ce The output for the user oy appears on the printer. Notice 
| that it is preceded by separator pages. The first name on 


each page is the userid (the second name is the jobname when 
running a DOS job). 
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& 92. %&If output also existed for the punch, the punch file would have 
: to be closed. Separator cards precede and follow each deck 
punched. | 


13. When running DOS, the close commands to the punch and printer are 
automatically issued by Job Control when a /& is encountered. 


14. Log off the systen. 
Ae Key-in: Log 
b. Depress enter 


NOTE: See lab instructor for userid, password, and ID card. 


Study Questions 


1. To enter VM/370 commands __ must appear in the lower 


right corner of the screen. 


2 (True/False) When several users with the same userid output to 
the same printer, they should place their own first or last name 
in their job cards. 


3. #(True/False) Before a user runs a job they should query files 
and purge any files left from a previous user. 


©@© | 4. (True/False) When running DOS jobs, the /& should always be 
included in the job, otherwise output will not occur until close’ 
commands are given by the operator. 


Answers 


1. CP READ : 

Ze True. By punching their name (as you should) in the job card, 
the second name on each separator page will identify the output 
for each user. | 

3. © True. Otherwise the input/output obtained may be that of the 
previous user. 

4.  #$True. 
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Loc 
OOOFTO 


OOoOF70 
OOOF 74 
OOOF 76 
OOOF78 
OOOFTC 
OOOF 80 
OOOF 82 
_QOOF 86 
OOOFS8A 
OOOF SE 
OOOF92 
OOOF 96 
OOOF9A 
OOOFAO 
OOOFAO 
OOOFAS8 
OOOFBO 
OOOFB4 


OBJECT 


4170 
1B55 
1866 


5860 


4155 
1956 
4770 
4110 
5010 
9D00 
9C00 
4670 
8200 


0005 


OFBO 
0001 


OF7C 
OF AO 
0048 
OOOE 
OOOE 
OFT4S 
OFA8 


CODE 


ADDR1L 


OOOOE 
OOOOE 


OOFAS8 


09000FB420000050 
0002000000001234 
OOOOFFFF 
E3C8C9E240C9E240 


LAB PROJECT 2 - Figure 1 


ADDR2 


OOFT70 


00005 — 


OOFBO 
00001 


OOF7C 
OOFAO 
00048 


OOF74 


OOF70 


" 
~ 
= 
~ 


OONOURWN & 
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SOURCE STATEMENT 


START 


BEGIN 


LOOP 


PCCW 
PSW 
CON 
DATA 


START X*FT0O°* 


USING *,0 

LA 7,5 

SR 525 

SR 626 

L 6,CON 

LA 52115) 

CR 526 

BC 7,L00P 

LA 1,PCCW 

ST 1,X*48? 

TIO X*OOE* 

$10 X*OOE* 

BCT 7,BEGIN 

LPSW PSW 

DS 0D 

CCW 9,DATA,X*20*,80 
DC X*Q90002000000001234' 
DC X *OOOOFFFF ® 

DC 


END 


CLBO*THIS IS IT® 
START | 


LAB_ PROJECT 3_- DOS/VS_FAMILIARIZATION 


This project exposes the student to the basic functions of job 
control--job to job transition, I/O device assignments, job options 
and operator controlled tape drive functions. The functions 
introduced are those associated with the job, assgn, listio, pause, 


UPSI, comment, mtc, option, exec, cancel, map, /* and /6& statements 


and commands. In addition, the student is exposed to JCL error 
messages and correction of the associated errors. 


A clear understanding of the material presented in this project will 
provide students with a foundation in batch job concepts on which much 
of the DOS/VS system and DOS/VS base course is based. 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Operate a DOS using basic job control commands. 
2 Given a job control error message, correct the statement causing 
the error. 


Time required to complete this project averages 1.5 hours. 


Tools, Test Equipment_ and Documentation 


DOS/VS Student System Residence Disk Pack 

DOS/SVS Work Pack 

DOS/VS Operating Guide SRL 

DOS/VS System Control Statements SRL 

DOS Familiarization Project Deck (Lab Instructor) 


Directions 


The following comments and questions reference Figure 1. Read the JCL 
comment statements numbered LP030001 through LP030016. Part I of this 
project is intended to highlight the commands and JCL statements 
necessary to sucessfully execute the job stream shown in the figure. 


1. There are _____ (how many) jobs in the job strean. 


20 (True/False) The LOG statement causes all JCL statements to be 
logged on the console. 


30 (True/False) The dump option in statement LP030019 will cause a 
dump to occur when a job is cancelled by the operator. 


| 


4. The command that will be keyed in response to stmt 1LpP030020 is | @ 


5. The statement that will be keyed in response to _ statement 
LP030021 is ‘ 


6. At the time the listio is issued at stmt 1LP030025, syYs005 is 
assigned to and SYS006 is assigned to 


SRI EN ec aintccin cana eaten 


Te The program at statements LP030027 through tLP030031, when 
executed, will —_ —_. (read cards/ program check/ 
loop). 


8. A pause statement allows the operator to take some kind of action 
1 before depressing the (end/ request) key to continue 
the job. | 


9. To stop a program that is looping and go on to the next job, the 
operator may key in __._.... (stop/ cancel). 
10. The listio, at LP030042 will show that SYS005 is assigned to 
and SYS006 is assigned to ® | 


11. The EXEC statement indicates that a program is to be loaded and 
executed. The EXEC at statement LP030033 will cause the program 


named —s_— to be executed. 
12. Statement LP030032 indicates _.._ (end of job/ end of 
file). 


13. When the job named LP3A is cancelled, the cards up to the next 
ee ee (/*-//EXEC-/&) will be flushed through and the pause 
statement at LP030042 will temporarily terminate the flow of the 
job stream until the operator depresses the end or enter key. 


14,  :«Céwils«sDe «OKeyed in response to statement LP030043. 

5. oo ~6will be keyed in response to statement LPO030044, 
16. ____ t—es—tsé<‘tWALdLL:«CHDE =CKeyed in hepponde to statement LP030045. 
Whe: cp _ will be keyed in response to statement LP030046. 
18. .0 tt  «Cwill be keyed in response to statement LP030047. 
19. _ will be keyed in resfonse to statement LP030048. 


20. AS a result of the generic assigns at statement LPO030044 and 
LPO030047, S¥YSO005 will, in each case, be assigned to an available 
(tape/ disk) drive. | 


21. The function of job LP3B is to read cards from SYSRDR and write 
the data on SYS005 which is assigned to tape. LP3C then reads 
tne data from tape and prints the data on SYSLST. The UPST 
statement at 1LP030050 turns — (Qlights/ input output 


devices/ bit switches) on or off. 
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22s __ will be keyed in response to statement LP030053. 


23. | will be keyed in response to statement LP030086. 


== 


24. A /& resets 


PD OPED CLEP OLED 


_.._.._ (permanent, temporary) assignments and 
(standard/ job control) options. 


25. A tape mark normally indicates 
file). 


(end of job/ end of 


o 
F 
@ 
ie 
ct 
~ 
oO 
an 


Obtain the lab project deck and execute the job stream. Use the 
DOS/VS system control statement SRL and the DOS/VS messages SRL to 
resolve any questions that arise. 
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SRRERHRHEHEERERHEEEERSE 


4 
4/ 
LO 
ff 
4/ 
* 

44 
AS 
44 
4/ 
ff 


BE 


/* 
44 


= 


HEKETCHKESEKESESKEKSEEREPLACE THIS CARD WITH 


DURING THIS PROJECT, YOU WILL PLAY THE ROLE OF AN OPERATOR AT A 
CUSTOMER LOCATION. AS SUCH, YOU WILL BE GIVEN DIRECTIONS FROM THE 
PROGRAMMER VIA COMMENT AND PAUSE STATEMENTS WHICH HE HAS INCLUDED IN 
THE JOB STREAM.THE INTENT IS TO EXERCISE YOUR SKILLS IN THE USE OF 
THE DOS/VS JCL STATEMENTS AS WELL AS COMMANDS FROM THE CONSOLE. 
YOUR RESPONSIBILITY, AS AN OPERATOR, IS TO FOLLOW THE DIRECTIONS OF 
THE PROGRAMMER EXACTLY, AND TO DO THIS IN A MINIMUM OF TIME. ANY 
DELAYS IN THE EXECUTION OF JOBS IN THE DAILY JOB STREAM WASTES 

THE CUSTOMERS VALUABLE SYSTEM TIME. AS RESOURCES» YOU SHOULD HAVE 
BOTH THE DOS/VS SYSTEM CONTROL STATEMENT SRL AND THE DOS/VS 
MESSAGES SRL WITH YOU AT THE CONSOLE TO ENABLE YOU TO QUICKLY 
RESOLVE OIFFICULTIES. YOU CAN FIGURE ON 15 MINUTES AS BEING AVERAGE 
TIME FOR A BEGINNING OPERATOR. SEE HOW YOU FAIR IN RELATION TO THAT 


TIME. ONCE COMPLETED AT THE CONSOLE, TAKE THE CONSOLE LOG BACK TO 

THE STUDY AREA TO SEE IF THE RESULTS COMPARE WITH THE STUDY QUESTIONS 
J08 LP3A 

EXEC BUGOL DO NOT REMOVE THIS CARD | 

G 


OPTION DUMP,LINK,NODECK | 
PAUSE ENTER A MAP COMMAND AND NOTE THE ALOCATIONS 
PERFORM A LISTIO TO THE CONSOLE FOR BACKGROUND AND NOTE THE 
PAUSE ASSIGNMENTS FOR SYSO05 AND SYS006. 
SGN SYS005,X*00C! 
ASSGN SYS006eX*OO0E! 
PAUSE PERFORM LISTIO AND NOTE SYSO0O5 AND SYS006 ASSIGNMENTS NOW 
‘EXEC ASSEMBLY 7 
START : , 
BALR 7,0 
USING *,7 
GIN B BEGIN 
END 


EXEC LNKEOT 

THE PROGRAM WILL BEGIN TO LOOP WHEN IT EXECUTES. DEPRESS THE ENTER 
OR REQUEST KEY IN ORDER TO TALK TO THE ATTENTION ROUTINE (AR). 

WHEN THE AR IS READY FOR COMMUNICATION, KEY IN CANCEL. YOU WILL HAVE 
TO DEPRESS THE END KEY TWICE AT THIS TIME. WATCH FOR THE DUMP. 


// PAUSE PERFORM A LISTIO AND AGAIN NOTE SYSO05 AND SYS006 
4/ PAUSE PERMANENTLY UNASSIGN SYS005 

// PAUSE TEMPORARILY ASSIGN SYSO005 TO GENERIC CLASS OF DISK 
4/ PAUSE PERFORM A LISTIO AND NOTE THE UNIT THAT SYSO05 IS ASSIGNED 
4/7 PAUSE PERMANENTLY UNASSIGN SYSO005 

4/7 PAUSE TEMPORARILY ASSIGN SYSOO5 TO GENERIC TYPE OF 2314 
4// PAUSE PERFORM A LISTIO AND NOTE THE SYSOO0O5 ASSIGN 

4/ JOB LP38 . 

4/ uPSt 1 

4/4 PAUSE MOUNT A SCRATCH TAPE ON DRIVE 280 

4¢ PAUSE TEMPORARILY ASSIGN SYSO0O5 TO 280 

4 


4] 


LA 


PAUSE USE THE MTC COMMAND TO WRITE 2 TAPEMARKS ON 280 
EXEC DITTO — | 
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JE KEKKERSEEKKSESKKEKESKEEEEKESKES 


LP030001 
LP030002 
LP030003 
LP030004 
LP030005 
LP030006 
LPC30007 
LP030008 
LP030009 
UP030010 
LPO30011 
LP030012 
LP030013 
LP030014 
LPO30015 
LP030016 
LP030017 
LP030018 
LP030019 
LP030020 
LP030021 
LP030022 
LP030023 
LP030024 
LP030025 
LP030026 
LP030027 
LP030028 
LP030029 
LP030030 
LP030031 
LP030032 
iP030033 
LP030034 
LP030035 
LP030036 
LP030037 
LP030038 
LP030039 
LP030040 
LP030041 
LP030041 
LP030042 
LP030043 
LP030044 
LP030045 
LP030046 
LP030047 
LP030048 
LP030049 
LP030050. 
LP030051 
LP030052 
LP030053 
LP030054 


$$DITTO CT 


DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 
DATA CARD 


$$DITTO 
$$DITTO 
$$DITTO 
46 

4/ JOB LP 
4/ UPST Lt 


4/ PAUSE TEMPORARILY ASSIGN SYSO005 TO 280 AGAIN 
// PAUSE USE THE MTC COMMAND TO FORWARD SPACE FILE OVER THE FIRST TPMK 
4/ EXEC DITTO 


$$DITTO 
$$DITTO 
$$DITTO 
4& 


WIM 
REW 
EOJ 


3C 


TP 
REW 
EOJ 


OUTPUT=SYS005 


OUTPUT=SYS005 
OUTPUT=SYS005 


INPUT=SYS005 
OUTPUT=SYS005 
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LP030055 
LP030056 
LP030057 
LP030058 
LP030059 
tP030060 
LPO30061 
LP030062 
LP030063 
LP030064 
LP030065 
LP030066 
LPO030067 
LPO30068 


~LP030069 


LP030070 
LPO30071 
LP030072 
tLP030073 
LPO030074 
LP030075 
LPO030076 
LPO030077 
LP030078 
LP030079 
LP030080 
LPO030081 
LPO030082 
tP030083 
LP030084 
LPO030085 
LP030086 
LP030087 
LP030088 
LP030089 
LP030090 
LPO30091 


LAB PROJECT 4 - PROCEDURE LIBRARY 


Implementation of the procedure library enables users to run re- 
petitive job streams with a minimum of JCL in card form. This project 
exposes the student to the statements necessary to implement 
procedures. This will enable the student to more clearly understand 
and utilize the proclib. | 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Create a job stream and catalog it in the Procedure Library. 

2. Display and/or punch the cataloged procedure from the Procedure 
Library. 

3. Correctly modify a cataloged procedure using overwrite 
statements. | | 


Time required to complete this project averages 1.0 hour. 


Tools, Test Equipment and Documentation 


DOS/VS Operating Procedures 
DOS/VS System Management Guide | 
DOS/VS System Control Statements ' 


Directions 

1. Execute PSERV in order to display and punch LPOO4. Add the 
necessary JCL to assemble and linkedit but not execute the 
program. Catalog the JCL and program in the PROCLIB by the name 
LBPROJ4. 

2a Display and punch the procedure you cataloged. 

36 Use overwrite statements to modify your job stream to assemble, 

| linkedit, and execute the program. Figure 1 shows the logic flow 

of the program and Figure 2 shows the intended output. 


4. Display and punch the procedure again. 
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Study Questions 


Does the use of overwrite statements permanently modify the 


1. 
cataloged procedure? ____ 

2 What character sequences are invalid as EOP characters? 

36 (True/False) It is an invalid operation to have an EXEC 
statement in a procedure whose purpose it is to call in another 
procedure. 

4. (True/False) An unnamed statement in a cataloged procedure 
cannot be modified. 

5. (True/False) SYSIPT data read from the procedure library cannot 
be modified by overwrite statements in the job strean. 

6. (True/False) A cataloged procedure that contains a JOB statement 
will not be correctly executed if the procedure is called by an 
EXEC statement that is immediately preceded by a JOB statement. 

T. To what device is SYSRDR (or SYSIPT) assigned during the 
execution of a PROC? a ee eee ee ee ee ae Renee 

Answers 

1. No - The modification is for the duration of the job only. 

2. There are 3 invalid sequences for EOP characters; //, /*, and /&. 

3. True — Procedures cannot be nested. 

4. True 

Se True 

6.0 True 

7. The assignment for SYSRDR is dummied-up by the system to point to 


the device from which the PROC is being executed (SYSRES). #£For 
this reason SYSRDR and SYSIPT assignments cannot be altered by a 
procedure (SYSIPT is assigned to the SYSRES device only when 
DATA=YES is specified in the procedure). 


Housekeeping 


Again 


Read 
From 
SYSIPT 


EOF 
oe co, ee End of Job 


*End of File Test 
Done in Subroutine ‘Read’ 


Reset Counter 
ToO 


Add 1 


Loop 1 


To Counter 


No Counter 
4096 
Yes 
Setup 


Move ‘Process’ 
To the 
Print Area 


[FE 121897] 
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Te TTT T TTT TT ee TET eT | 
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LAB PROJECT 4 - Figure 2 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


CARD NUMBER 
CARD NUMBER 
CARD NUMBER 
CARD NUMBER 
CARD NUMBER 
CARD NUMBER 


AM EWN EF 


** * KK KEK EADROCESS 
*kKKKKEKEXDROCESS © 
* * KKK KKK EKDROCESS 
**K KKK KEKEKDROCESS 
* & & KK KK KK EPDROCESS 
** * KKK KKK EDROCESS 


SAMPLE PRINTOUT 
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LAB PROJECT 5 - DISK FORMATS 


This project re-introduces students to the topic of disk formats. 
Students are required to locate a particular cylinder and head and 
then to identify the home address, count, key and data areas. 
Understanding of this topic provides a base from which knowledge of 
the DOS/VS sysres organization can be built. The programs DITTO and 
DASD PRINT are introduced as aids in displaying areas of disk. 


* @ 


ective 


ETD ED 


O 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Run the Ditto Program to print out a track of 2314 Disk Pack. 

2 Use the printout from the Ditto Program to identify areas on the 
track. 

3 Observe differences in a Ditto Dump of DASD compared to a disk 
dump progran. 


Time required to complete this project averages 1.0 hour. 


EPR? ED Ey EE ER? GP ED 


SRL FOR 2314 


Directions 


Each system in the lab has the DITTO program in the core image 
library. Use this program to obtain a dump of cylinder 199 head 0. 


Use this printout to answer the study questions. 


Then use // EXEC DAPRINTR to answer any questions that DITTO did not 
provide. It may be necessary to ASSGN SYS000 to disk drive 130. 
Do Not Delete Any Unexpired Files. After execution, return 
assignments to their original devices. 


Study Questions 


Complete the statements below in hexadecimal, except where DEC is 
noted, using the Disk Dump Program printout of cylinder 199 head 0. | 


Length of HA is 


1. ___ bytes. 

2. Contents of HA area is ss i(‘(<(‘ 

3. The flag byte indicates this is a _ oe eer (operative/ 
alternate) track. 

4. The length of RO count area is bytes. 

5. The RO ID is cylinder _ » head _.._.. and record 

6. The RO ID is cylinder (DEC), head ___ _. (DEC) and 
record __ decimal. , | 

7. The RO key length is __ _ bytes. 

8. The RO data length is bytes. 

9. The R1 count area length is __ _.._. bytes. 

10. The R1 key length is _ _... bytes. 

11. The R1 key area contains ay (DEC) bytes of hexadecinal 

12. The R1 data area length is __ (DEC) bytes. 

Answers 

1. 5 

2. 0000C70000 

3. Operative 

4. 8 

56 00c7, 0000, 00 

6. 199,0, 0 

Te 0 

8. 8 

9. 8 

10. 2C 

11. O4 

12. 96 


LAB PROJECT 6 - POWER OPERATION 


POWER provides support for spooled input and output under DOS/VS. The 
greatest advantage of spooling is faster overall throughput. This is 
achieved by enabling inputting, processing and outputting of jobs to 
occur independently from each other. When we allow this to occur, 
System I/O units are able to operate at maximum speeds. 


In order to operate POWFR, students must be familiar with the 
associated JECL statements and console commands. The intent of this 
project is to provide students with the skills needed to operate a 
DOS/VS system with POWER initiated. Consequently, only those 
statements and commands necessary to achieve those skills will be 
iatroduced. | 


Objective 


Upon completion of this project, students should ke able to operate a 
DOS/VS System using POWER. Students should be able to operate POWER 
by performing the following tasks: 


Te Use Queve management console commands to: 
ae Display the status of any job in the POWER systen. 
b. Delete a job from the input queue. | 
Ce Release a job from the input queue. 
Ze Prepare or correct POWER job entry control statements that are 
required to execute a job with the following conditions. 
ae Assign priority to any job. 
b. Execute the job in a specified partition. 
Cs Hold a job in the input queue. 


Time required to complete this project averages 1.0 hour. 


Tools, Test Equipment and Documentation 


DOS/VS Operating Procedures 
POWER SAMPLE DECK 


PART 1 - JECL AND POWER COMMANDS FAMILIARIZATION 
Directions | 


The sample deck for this Lab Project is complete with the exception of 
the power JECL needed to run in a power environment. The following 
diagram will assist you in preparing the necessary JECL to run the job 
stream. The numbered statements indicate the JECL which you will be 
required to punch and insert in the sample deck obtained in Part 2. 
Enter the appropriate operands in the underlined areas of the JECL 
statements. All jobs are to be entered in the hold state and run in 
BGe 


1. * $$JOB se Ay De 
// JOB ASSEM 
J& 


2. * $$ __ 


3m * $$SIOB seis naa esapiiminemias maniac Conis 
// JOB SECOND 
/& 


4. * S$SEOI 


5, BG 


5. * $$ Third, 
/f/ JOB THIRD 
J/& 


6. $$ 


A ED RS SEE ED 


Te * $$ JOB LSERV 
// JOB LSER 


i aera aes 


/& | 
Da eet eset oe 
9. Sa en OO ns ae gg 
// JOB ASSES 
/& | 


10. * $$EOJT 
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POWER COMMANDS (Answer the following) 


1. To display the input queue for background, depress the Request 
Key and KEY-IN : 


a fa cement heated 


2 To alter a Job named XYZ ‘from a priority of 5 to ae higher 
priority of 6, depress the Request Key and KEY-IN * 


CP Se 


te 


RT 2 - EXECUTION OF JOBS UNDER POWE 


Directions 


This project should not be performed under VM/370. Obtain the POWER 
Sample deck and add the necessary POWER control cards to run the jobs 
under POWER. After the jobs have been read into the INPUT queue, 
display the queve. Alter the priority so the last job entered in the 
queue will execute first and then delete the job named LSERV. Display 
the queue to check the results. Release the remaining jobs and allow 
them to execute. 


NOTE: JECL does not replace standard DOS job control. 


Jobs running under this power system have a default priority of 5. 


The POWER program (FGPSPOOL) must be initiated on the system before 
PART 2 of this lab project can be executed. If POWER has not already 
been initiated on the systen, use the procedure on the following page 
to do so; then execute PART 2. 


POWER INITIALIZATION PROCEDURE 


IPL the System 
Ole3sa SPECIFY SUPERVISOR NAME 
GOtO4at LELQEV=*?’ 130" sVOLSER@1LiLiddee "ie UT Ogogo gg god a 
OSOL DATE@O6 715/74 e CLOCK G4 759 £00» ZONE eh AST eOO- 00 
Olio GIVE TRL CONTROL COMMANINS 
gat | 
cle cl 
OfS20 PAGE GaTAa SET EXTENT LCL HIGH 
Laks Oo iva ie f 
OieO Cos els TRL COMPLETE 
Ro DP booR ke Eg AMY FOR COMMUN TD OAT tL Vb LS a 


0  ———"End/Enter Key and press Request Key 


blécea READY FOR COMMUN T OAT IONS . 
ae bateh fib 
SEE 
{ts ty 
ee 


AgSun STS TTT | 
ff @®S50N SY¥S002e# Lat POWER OATAPTILE 
i L BL OA i ART Ly PRPOWER VN TAT AP CLE? 9 Pe aoe De 
EXTENT SY¥SOO2e 17020. Lede Oy BORO T9O0 
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* Key in DELETE only in response to the 4733A message. Should any 
other message print, contact your instructor. 


NOTE: All underlined entries are to be made by the operator. 
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LAB_PROJECT 7 - LABEL EXTERNALS 


This project extends the student's knowledge of JCL to include the 
function, content, format and sequence of the DLBL and EXTENT 
statement. The student's understanding of the material in this 
project is prerequisite to the topic of Label Processing Techniques in 
the next project. 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Correct any errors in EXTENT and DLBL information. 


Time required to complete this project averages 1.5 hours. 


Tools, Test Equipment and Documentation 


DOS/VS Operating Procedures 
DOS/VS Control Statements 


Obtain the deck called LPO007 from the PROC library. Correct the 
labels to conform to Figure 1 of Lab Project 7. All of these labels 
are for disk 131. After all errors have been corrected, the job will 
execute and give you a printout like Figure 2. Save the corrected 
label cards for Lab Project 8. 
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LAB PROJECT 8 - INTRODUCTION TO LABEL PROCESSING 


When using disk files as input or output, labels must exist on the 
label information cylinder to identify and locate the file. In this 
project, students are required to excercise skills in placing labels 
in both the standard and temporary areas of LIC, executing a program 
requiring those labels and displaying the contents of those label 
areas. 


Upon completion of this project, the student, using the available 
documentation, should be able to: ; 


ue Identify the three general areas where labels are located on the 
label information cylinder. 
2 Code a job stream to place labels in any of the three LIC areas: 


System standard, partition standard, or partition temporary. 

3. Describe in general terms the types of labels used by DOS/VS and 
their functions. 

4. Display the labels contained on the LIC of a DOS/VS SYSRES_ pack. 


Time required to complete this project averages 1.5 hours. 


Tools, Test Equipment and Documentation 


LLLP ELT ED ALP EY SLE TY 


DOS/VS System Management Guide 
DOS/VS Data Management Guide 
DOS/VS System Control Statements 


Directions 

Use the label set that you corrected in Lab Project 7 to create labels 
for the F4& partition standard area. Create a job stream to place 
these labels on the F4 partition standard area of the label 
information cylinder. Use the DOS/VS POWER system to make F4 active. 
Use LSERV to obtain a printout of the labels. Answer the study 
questions. 


© HEURV pres LIC, from Laat egbeloton SHSIES , amie SYSLST . JabContiol Ldmrey LBL wo BatasROP 
e VOC fen i adn basis wits. 
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Study Questions 


(True/False) The OPTION statement is used to specify the 


1. 
partition with which a label set is to be associated after it has 
pace written on the LIC. 

2e (true False) If there is no option statement preceding a label 
set, the label set goes to the system standard area of the label 
information cylinder. 

a (True/False) If a new label is to be added to the background 

| standard label area, all labels already on that track must be 
included in the new job stream or they will be deleted. 

4. Describe a method to display the partition temporary area of the 
label information cylinder while it contains labels. 

5< Why might expired dates be used in label cards? 

Answers 

1. False - The partition in which Job Control is executing de- 
termines the partition with which the labels will be associated. 

2.2 False — The label set goes to the partition temporary area of 
LIC. 

36 True | 

4. Use // EXEC LSERV as a job step after the label cards (set) and 
before the /& or a new // JOB statement. 

56 If frequent changes are made in an output file or work files, it 


makes it unnecessary for the operator to type in DELETE when the 
file is opened. This procedure should be used with caution since 
the file is not protected. 
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LAB_PROJECT 9 - DOS/VS BUG SYSTEN | @ 


Objective 

Upon completion of this project the student should be able to: 
1. Apply Bugs to the DOS/VS System for T/A Problers. 

2. Remove Bugs from the DOS/VS Systen. 


Time required to complete this project averages 0.5 hour. 


Tools, Test Equipment and Documentation 
DOS/VS System 


Directions 
1. IPL the DOS/VS systen 
20 When the "BG READY FOR COMMUNICATIONS! message prints enter: 
ae // EXEC BUGO1 | 
3. §$ The system will respond: . | ® 


BG SYSTEM IS BUGGED 
BG 1IOQOOA READY FOR COMMUNICATIONS 


NOTE: This message sometimes will not be printed. Instead ‘IPL TO 
CONTINUE! will be printed. If this occurs, IPL the DOS/VS 
system again to continue with the bug applied. 


4. To continue, enter the job stream as called out for each T/A 
Problen. Obtain the deck for T/A 6 and submit it at this time. 
DO NOT SHOOT T/A 6 NOW. It is being used only to give you a 
sample dump for this project. 


ae An error message and a dump should occur. 


b. Verify that the dump starts at storage location x'080000'. 
This indicates BUGO1 is on the systen. 


Ce Retain the error message and dump for use later. 


@& ‘Se When it has been verified that BUGO1 is on the system enter: 
a. // EXEC DEBUG to remove the bug from the systen. 


De Use the error message and dump from STEP 4 to go on to TSA 


STUDY QUESTIONS 
1. What is the address of the PSW in the dump? 


Zu What is the address of general purpose register 1 in the save 
area? | 


3. What is the starting address of the program? Hint: Check link 


edit map. 
ANSWERS 
1. 080008 
26 080030 
3% 080078 
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IPL the — 
System 


Set Date=04/01/74 
Clock=00/00/00 


// EXEC BUGnn 


nn=Bug Number 


Message 
From the 
Bug 

System 


‘System is Bugged’ 


System is Bugged’ 


‘Re-IPL to Continue’ 


a | 
i] 
Bug is 


Applied to Submit 


The System Required Job 
Control 
Statements 


SET DATE=04/01/74 
SET Clock=00/00/00 


Note: 1. // EXEC BUGnn will remove any 
bug on the system and apply the new 


bug. 

2. // EXEC DEBUG will remove any 
bug on the system. 

3. Every time the system is |PLed, 
it will remove any bug on the 
system. 
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a 


LAB PROJECT 10 - PHYSICAL INPUT/OUTPUT CONTROL SYSTEM MACROS 


The physical IOCS macros, EXCP, WAIT and CCB are used in the DOS/VS 
system as the problem program's means of making I/O requests to the 
supervisor. No matter whether the source program was written in basic 
assembler COBOL, Fortran, PL1, etc. While performing this project, 
students will correct errors in these macros and execute the program 
provided. The PIOCS interface between the problem program and the 
supervisor provides the foundation on which the logical input output 
control system (LIOCS) for handing data files is built. Student 
understanding of PIOCS is an essential element in grasping the 
concepts and implementation of LIOCS covered later in the course. 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: | 


1. Correct any source statement coding or logic errors in the use of 
the EXCP, WAIT, CCB, PDUMP or EOJ macro. 


Time required to complete this project averages 2.0 hours. 


Tools, Test Equipment and Documentation 


DOS/VS Supervisor and I/O Macros 
System/370 Principles of Operation 


Directions 


Obtain a deck of cards from your lab instructor or the procedure 
library. The procedure name is LP010. The source program uses PIOCS 
macros to do an 80/80 list. Figure 1is a flowchart of the progran. 
The source program contains coding and logical errors. 


NOTE: Do a // EXEC BUGO1 at the console before running your source 
. deck. This will prevent an unnecessary dump of the 
supervisor. | 
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Study Questions @ 


1. Which bit in the CCB is tested to determine if an end-of-file has 
occurred on a 2540 reader assigned to the symbolic unit SYSRDR? 

2~ What is the mask for the test under mask instruction used to 
check for this condition? | 

3. What value must the third operand in the CCB have to allow this 
test to be made? 

Answers 

1. byte 2 bit 1 for SYSRDR or SYSIPT only 

2. x*4gor 

3 The third operand indicates user options. This is not a _ user 


option so the third operand is not meaningful to this test. 
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LAB PROJECT 11 - DISK READ AND PRINT 


This project exercises the student's skills in the debugging of PIOCS 
programs. It is a review of the PIOCS macros covered in the previous 
lab project as well as.a review of disk channel programs. The overall 
function of this progam (read volume label and VTOC and print the 
information on the printer) will be repeated in the VS macro project. 
This project then will provide the students with a better base for the 
VS macro project. 


Objective 


Upon "completion of this project, the student, using the available 
documentation, should be able to: | 


1. Correct logic errors in a source program. This program will read 
seven records from a disk pack and print the records. 


Time required to complete this project averages 2.0 hours. 


Tools, Test Equipment and Documentation 
Figures 1 and 2 for this project 
IBM System/370 Principles of Operation 


Directions 


Obtain a source deck from your lab instructor or the procedure 
library. The procedure name is UP011. The program is to read the 
Volume Label, extract the address of vVTOC from the label, and then 
read 6 records from the VTOC. Verify your program's output with the 
lab instructor. | | 


NOTE: Do a // EXEC BUGO1 at the console before running your source 
deck. This will prevent an unnecessary dump of the 
supervisor. 


Volume Label - This record is on cylinder zero and its format is as follows: 


Data Area (80 Bytes) 


(4 Bytes) 5 Bytes 
, Contain 11 Bytes Contain 

‘'VOL1’ The VTOC 
Address 


CCHHR 


VOTC Area Record is as Follows: 


Key Area Data Area 


Count Area 
(8 Bytes) 


(44 Bytes) (96 Bytes) 


[FE 121551] 
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_-* 


e@ Load Base 
Register 

e Load R3 

Record Count 


READVOL 


Read the 
Volume 
Label 
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Volume 
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Field Seek 
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(FE 121901] 
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LAB PROJECT 12 - LINKAGE EDITOR 


The intent of this project is to familiarize the student with the 
statements required to utilize the linkage editor. Student knowledge 
of this topic is essential to future understandings of the total 
process of coding, assembling, linking, and executing programs. The 
project presents a structured approach and logical method for problen 
solving as it applies to user errors in jobs. This is intended to 
enhance the student's ability to complete tasks of this nature in a 
logical fashion. | 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Correct control card errors in a job stream that links 5 modules 
together to form a two-phase progran. 

2. | Punch a REPLACE card to correct an error in an OBJECT module. 

3. Identify the record types contained in an OBJECT module and the 
contents of each field in the various types. 


Time required to complete this project averages 2.5 hours. 


Tools Test Equipment and Documentation 
DOS/VS Base SCM 2 


DOS/VS System Control Statements SRL 
DOS/VS Messages SRL 


PART 1 


Read the following: 


This portion of the project is intended to help organize the student's 
thinking and assist in developing a logical approach to the errors in 
the associated project deck. The approach that will be used consists 
of: | 


1. Understanding the overall function of the job. 


2 Breaking the job into units. 


3e Breaking down the units into individual statements. 


4. Attacking the statements in each unit, one unit at a time. 
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In essence, this approach is geared to reducing a difficult problem 
into smaller, more easily solved elements. This problem-solving 
exercise deals in particular with the linkage editor. However, the 
same techniques may be used in solving most user coded errors. Let's 
apply the 4 steps above to the project deck. Refer to LAB PROJECT 12 
- Figure 1 in DOS/VS Base SCM 2 and read the following: 


1. What is the overall function of the job? The job is a link and 
go. It links 5 modules into a 2-phase progran. 


2 What are the units of the job? There are 4 units into which the 
job can be broken down. | : | 


ae Job control statements 

b. Linkage editor control statements 
Ce Object module statements 

d. Data cards. 


3. What are the individual statements within each unit? The job 
control statements are: JOB, OPTION, EXEC, ASSGN, /*, etc. The 
linkage editor control statements are : ACTION, INCLUDE, PHASE, 
etc. The object module statements are: ESD, TXT, RLD, and END. 
The data cards are O01P, O2P, O3P, etc. 


G. How are the errors in the statements to be attacked? First, 
let's understand the types of user errors which can be enc 
countered in a job: . | 


ae Format errors - This type of error is caused by incorrect 
positioning, length or punctuation of operands. : 


b. Functional errors - This type of error is caused by coding 
operands in a statement which are not consistent with the 
intended overall function of the job. 


Ce Sequence errors - Sequence errors result from ‘missing, 
duplicate or out-of-sequence statements. 


d. Content errors - Incorrect spellings and values for operands 
are statement content errors. 
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Now, based on your knowledge of job control and linkage editor control 
statements, fill-in the following pattern with what you believe to be 
the corrected statements that will cause the LINKEDT BUGS to execute 
properly. | | 


// JOB LINKEDT BUGS 


GP a ee 


SED LLL ELLIO SLED LEE LLLED PLIERS OED LE ELLE TELS 


object module deck 


object module deck 


object module deck 
object module deck 
/* 
// EXEC 
TOT Pec a e 
1, pe 


1 aga AO REN RR 


data cards 
/* 
& 
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PART 2 | : & 


Directions 
Ootain the project deck. Correct the statements that you have already 
determined to be in error. Run the job. Error messages during link 
edit indicate unresolved errors which should already have been 
corrected. Correct those errors first. Then correct the errors in 
the object modules via reps. Use the same approach that was used for 
the JCL and link editor control statement errors. Also use the System 
Control Statement SRL, the assembly listings, the deck listing and the 


Sample output to complete the project (Listings are in DOS/VS Base SCM 
2) - 


LAB PROJECT 13 -_VS_BACROS AND_S/370 INSTRUCTIONS 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Locate and correct, using an assembler listing and system dumps, 
the cause of program checks and/or incorrect output resulting 
from the improper use of VS macros and S/370 instructions. 

Qe Interpret and relate the significance of the various fields in 
the output listing of a correctly assembled sample program that 
employs VS macros to the specified macro parameters in the source 
coding. 


Time required to complete this project averages 2.5 hours. 


Tools, Test Equipment and Documentation 


1. Source listing and deck 
2~ DOS/VS Supervisor and I/O Macros 
36 DOS/VS Messages SRL 


Directions 

1. The deck is a 'link and go source deck for the job MCROASSM. 
This job assembles and executes (when debugged) various VS 
macros. There are several errors in the source deck which must 
be corrected before good output can be obtained. See Figure 1 
and Figure 2 to determine the oepration to be performed by the 
program. | 

2- Obtain the deck and a listing of the cards for the project. 

3. Debug and execute the program. 


4. Complete the study questions. 


Study Questions 


1. If the return code for the RUNMODE had been X'04', what message 
would have been issued? 


SS NS ATED cD SY aD 


26 (True/False) The EXCP REAL macro requires that the addresses 
within the CCWs be real addresses. 


cP (True/False) A return code of xX'08* for a PFIX indicates that 


the PFIX may be reissued later if PFREE is issued in the 
meantime. 
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Answers 


1. Program Running REAL - Cancelled 
Oe True 
oe True 
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Volume Label - This record is on cylinder zero and its format is as follows: 


(4 Bytes) 
Contain 
'VOL1' 


Data Area (80 Bytes) 


5 Bytes 
Contain 
The VTOC 
Address 
CCHHR 


11 Bytes 


VOTC Area Record is as Follows: 


Count Area Key Area Data Area 


(8 Bytes) 


(44 Bytes) (96 Bytes) 
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LAB PROJECT 13 - Figure 2 
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PRTOUT 
eload R6 
Save Area Addr 
Reload R3 
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PRTOUT 2 
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(Virtual Addr 
of Data) 
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Yes 


PRTVTOC 


PFIXSTOR 
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PFIX Using 
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MAKEREAL 


REALVTOC 
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with Virtual 
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Store 10-13 
(Real Addresses) 
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No 
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Invalid Virt 
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VSMACROS FLOWCHART (Part 2 of 3) 
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A 
PRTVTOC 
Load R10-13 
With Addresses 
B 10=CCB 
11=CCW 
12=Header (Key) 
13=Data (Key 
Store 10-13 
Cc In Save Area 
for Re-use 
by REALAD 
Calculate 
Lengths for 
0 PFIX 
R11 and R13 
E 
PFIXSTOR 
F 
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No 


PRTOUT2 
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VSMACROS FLOWCHART (Part 3 of 3) 


SDAID, as well as other programs such as PDAID, are tools designed to 
assist the PSR in quickly isolating program failures during execution. 
As such, students with a sound understanding of SDAID operation and 
capabilities have enhanced problem determination ability. This 


project provides the students with an opportunity to exercise their 
skills in the various functions of SDAID. 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Use SDAID to locate a failing instruction. 


Time required to complete this project averages 2.0 hours. 


SADP SRL 


Directions 

During this project, you will execute a program named Rocky. Based on 
keywords given by the operator, Rocky injects different bugs into the 
supervisor and then turns control over to the supervisor to cause the 
bug to appear. The student's objective in this project is to use 
SDAID to find the failing instruction in supervisor, not to trace the 
execution of Rocky. 


The project contains 2 bugs. Show the lab instructor the failing 
instruction but DO NOT DEBUG. 


1. Execute "ROCKY! from the console (// EXEC ROCKY). 


2 Rocky begins to execute and issues a read to the console. 
Depress the End Key. 


3. Enter the keyword reply to the message ROCK IS: 


ae "END! key (Bug #1) 
b. ROCK CANDY | (BUG #2) 
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OLTEP is run to exercise I/O devices. This is normally performed by 
a CE or a customer to verify a problem on a device which is suspected 
to be failing. This project is intended to expose the students to the 
operation of OLTEP since as PSRs they may be requested to assist in 
the implementation and operation of OLTEP. Students are also given an 
opportunity to exercise their skills in the fetch/trace function of 
PDAID, an effective tool to be used from this time on in pinpointing 
a failing phase within a multi-phases frogran. 


Objective 


Upon completion of this project, the student, using the available 
documentation should be able to: | 


1. Use the OLTEP SRL to initialize OLTEP. 
2u Use PDAID Fetch/Trace Function to observe phases used to run the 
1403G test of OLTEP. 


Time required to complete this project averages 1.0 hour. 


Tools, Test Equipment and Documentation 


OLTEP SRL 
DOS/VS System Serviceability Aids Logic 


Directions 

1s Initialize the Fetch/Trace function of PDAID. 
2% Initialize the OLTEP to run the 1403G test. 
30 Save the output as an aid for the OLTEP T/As. 
4. Deactivate PDAID. 


5 Run the 1403H test to restore the UCS buffer in the printer. 
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LAB PROJECT 16 -— DUMPGEN 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Punch the control statements necessary to create a 
standalone dump program uSing DUMPGEN. 

2. Identify the limitations of a dump produced when the 
created standalone deck is executed. 

Time required to complete this project averages 0.5 hours. 


Tools, Test Equipment and Documentation 


DOS/VS Serviceability Aids and Debugging Procedures (Section 2-A-3) 


Directions 


Use the documentation to create a standalone dump deck using DUMPGEN 
with the following options: 


INTERRUPT=NO 
DECKS=1 
PPOOL=NO 
FORMAT=YES 
TAPEIPL=NO 


Run the job to create your deck. Retain this deck for your use in 
future lab projects and T/As. | 


249 


Study Questions 


1. How many OPTN statements were required in your job stream? 

2. If, at a later time, you wish to generate two additional decks, 
can you add a DECKS=2 operand to your FORMAT=YES option card? 

3. The required ASSGN for DUMPGEN execution is — 

4. (True/False) The dump will give a printout of all of real 
storage. , 

Answers 

1. One (1) - FORMAT=YES (the others are defaults) 

2~ NO - Only one one operation and only operand per control 

a statement is allowed. 

36 SYSLST, X'*CUU' (if this ASSGN is omitted, X*OOE* is 
assumed) 

4. False. Bytes XK'00'-x'17", X*4O'-X'4B", X"BA-BB', and 214 


bytes of a non-critical area of supervisor are not dumped. 
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Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Execute the EREP program from SYSLOG. 


2 Interpret data obtained from SYSREC when the program is 
executed. 


Time required to complete this project averages 0.5 hours. 


AS PTS SATS ALPS SAY AS SD ED PE I SS AS ES TD EP ay 


DOS/VS Operating Procedures 
DOS/VS Serviceability Aids and Debugging Procedures 


irections 


1. Use the SADP manual as a reference to execute the EREP program 
SYSLOG with the parameter: 


OPTION EDIT 


Qn Use the obtained printout and the SADP to answer the 
study questions. 


1. What options, if selected, clear the SYSREC file? 


o> DD GD Genes ame ae ee ae ce ab ep ee ee Oe eee eee eee ee 


2a What is the command code and data address of the failing 
CCW in the first edited output of an I/O device? 


<-> aE ene ee eee 


36 What was the time and date of the failure? 


4. How many Start I/Os were issued to this device by this pro- 
gram before the failure occurred? 


5. What type of error caused this SYSREC entry? 


tp ee en angen epee ae eee em 
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fron 


Answers 


1. CLEAR,HIST (DO NOT EXECUTE THESE OPTIONS IN LAB). 


2. The answers to Questions 2-5 are found on the printout ob- 
tained from executing EREP: They may vary from system to 
system. For assistance or to verify your answers, check 
with a lab instructor. 
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LIBRARY DISPLAY PRCGRAMS 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


Vs Use the library display program to display the directories 
for any library on SYSRES. 

2% Use the library display programs to display any library 
or element of any library on SYSRES. 

3. Interpret the output of the display programs. 


Time required to complete this project averages 0.5 hours. 


Tools,Test Equipment and Documentation 
DOS/VS Serviceability Aids and Denugornd: Procedures 
DOS/VS Operating Procedures 


Directions 


1. Punch the control cards necessary to display the core 
image directory. Use the control statement that will list 
the directory in collating sequence. Save the output to 
answer the study questions. 


2a Punch the control cards necessary to display the phase 
| IDCDBO1. Save the output to answer the study questions. 


Study Questions 


Is The beginning disk address of the core image directory is 
cylinder head _ _.... record _—s—a— wt 

2s The number of tracks allocated for the procedure library 
directory is tracks and the procedure library is 


eal 


allocated ___ cylinders. 

i (True/False) In a sorted DSERV of the core image directory 
‘$IPLRT2 displays after $$RASTOO. 

4. (True/False) A DSERV of the core image directory gives a 
status report of all of the directories and libraries on 
SYSRES. 

oye Phase IDCDBO1 is bytes in length. 
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Answers 


1. 


2 


Se 


5, 14. These are values for our lab system and not a fixed 
value. The directory and library size for each library is 
set at system generation time by the customer. 


True. The sequence is $$ phases, followed by $ phases fol- 
lowed by alphabetic sequences. SEE NOTE. 


True. It indicates the space allocated, the remaining avail- 
able space, the number of deleted blocks and other information 
of significance for potential condenses of libraries or 
planning for a new SYSGEN. 


1170 bytes. This may be found at the top of the CSERV print- 
out or the DSERV by noting there are 2 text records in the 
phases and the last record has 146 bytes of text. A full 
record has 1024 bytes for the 1170 byte total. 


NOTE: With DOS/VS Release 29 (and later) CORE IMAGE 
Directory entries are always maintained in collating 
sequence. It is therefore NOT necessary to use the 
DSPLYS statement when displaying the CORE IMAGE 
directory to obtain a sorted output (DSPLY is 
sufficient). 


The DSPLYS statement is still required, however, to 


obtain a sorted output when displaying the 
RELOCATABLE, SOURCE, or PROCEDURE library directories. 
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LAB PROJECT 20 - SCP INSTALLATION RESEARCH 
Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Given a representative system, determine the PTFs that 
must be applied during an SCP installation. 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 
RETAIN/360 Terminal 


Memo to User | 
Program Status Document 


Directions 


This lab project is the first in a series that deal with the 
installation of an SCP. Study Figures 1, 2, and 3 in this lab 
project closely for the target system the SCP will be installed 
on. If there are any questions about the target system, consult 
your instructor. The first operation you will do is to research 
the PTFs required for the target system. Ask your instructor 

to schedule you for time on the RETAIN/360 terminal to pull the 
latest PTF information. Your instructor will also give you the 
password. 


Obtain the following publications from your lab instructor: 
~ Release 29 Memo to User 
- Release 29 Program Status Document 
- PTF Cover Letter 
- EWS 


Obtain the following publications and the RETAIN/360 printout to 
fill out the following forn. 


Discuss your answers with the lab instructor. 
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Minimum EC LEVEL 


APAR # 


Describe any 


PTF# 


PRY AD ENS AENEAN ‘east 


Re SPEDE EY SL 


SE -ED AERRED ENED ote 


Student's Name 


eee ORD mee SD SEY GREED ATE CUED NT Ge CEES CSU EESED Aer AEE eae Ry SOD NERD eee aie pS ee 


EE DY OED CEE A AD OER CE rae 


(Indicate if PTF is on PID 


Tape, PTF Tape 290 or EPC). 


a AEE URES? NS TIERS EE HITE WERE SRST MEER SHTEONS CRUE CHEE CPOMETD meee Te GENE AER SRE LS TD GLUED corte ee 


SES SED SEED TED RENTED ERY CREE CERF SRD VERA SURES OES AIRED OLD CEN AS IEE er ERED HAS SOE OT eID 


FER CRE AEE AD HOT ASR Se CUEEED meeRT NE AERIS TLE ERR Ke EET ORT ARLEN PRE oR SLT SRD 


TL: LS ES A TS RD <LI SRY ED NUTS I RPTL OED Ray eNO “Ae OR AA REN eR ARAD catOh catia wren eT 


AE St rr ETC EE EI EE RT ET ENE ARTO ORES Seto ccs amp MAR AERA OLE A RORY AER CRI AER 


NE ROT AEA UEP TEN SRE! EE AE AUNTS OR AOC OR SONS EMA AY NED ET IY EE RAT: CR I AAR eT, PRONE IO wee 


EO Ae TT EEE TOD: ENTE TENTS TOU URES ce CONS THEE ENERO! LEED rcrND AEE eR RAIN <TR CONDE SRESDD SOURS EE TN ES AO eS 


SAE UGE COTS Lee SRD SEE ARES ee eA AOSEED EPROM ONES intrest TS i CER AE on ire emer Bur ATT 


ADA AE ARI PLE NDE SE ACNE SE AEE OY EAPO AEN ARE ETD AOD AD AR SORA I NNER pa ROL 


cnennasentnendionommesatenmesndiatnmesna ae Ton 7 eaesiivinsarer okonantastia itera Maatmmseateemmnatedindiaien Dh naiaitetinnentitact i aaeaertinti tase Tne on akon enna kan mc iinai en teiedtintne iid aiidimenteame nite aia t 


LEO AE CE AAS ILD A LEE ELE A CNG LOE TO AEE: ION IN OD OE TE! AES AIO OR OE EO LEAEEY ORI 
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Wied 


ane Mt LSeb 
ik tit colt aa Sis 
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TE AA A AE A TE NS NS NS PN IE A ENTS SNPS SET UA OR ULE ED IN SOUCY TKD OED ES AD EE TY TAO SL AD ES APY ET SENET SIND AY AE OS AE EU: TE 
RAS EETO IAD EEN: CED SER RIE OAD ETD ALG SOG RCE SceeY ALi A CDAD PSNR: CORE: OM EEO OED AA LINN SI “GREER SOMES ACY AOE ASTER EMO URI STRING ESTEE REP RT 
RARER ARSE OE ANTAL ALLRED RLY TLR SSRN I SCS SRNODE SEIS OED AIA ARN IY REY ALS NLD CMTE AAT ENT OE ED CED AED AY AED CD RT SEE SMES RE ATT TERED TERE ET CSTE SSE Er EL AAR SNARES 
SN AY AOA ATP ATE LL ALE RA VANTIN CERI LAN COTS EBD ATES GL SETI OE TY A TS EN EE VE SEE ARTS IY ET RD OO AOR PETS AEG EN CEE TER ED ER NRE CRETE AMD cami Ao wan 
FS GE RECS AED AEE ANY ETI ARE AT AS AD ATED ONS CS EID GLEED ATER AEROS OEE SES ERPS OR ENOTES AOE IEEE GIES ARE AEN ERE RETO ETS SORE EED Soatro oeaRY 


A CLS CERES CITES LEILA CIES ETS TO EE LES AS A STP LY TA IE REMY ID CIA BND IP LI AES SITET ELD LAGS NEED LP LP AO PLATTS ETS ATS AD TES AOS AS AEE AE ESD OT TI 
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Oojective 


Upon completion of this project the student, using the available 
documentation, should be able to: 


/\. Restore a PID system from tape to disk. 


/ 2 IPL a PID system using supplied control cards and correct 
all errors. 


Ae Catalog a set of standard labels on a PID systen. 


Time required to complete this project averages 2.5 hours. 


Tools, Test Equipment and Documentation 


/PID Tape 
emo to User 
Program Status Document E/n 
PTF Cover Letter 
/ System configuration figure from lab project 20 


Directions 


Obtain copies of the above materials from your lab instructor. 
Punch out the procedure "SCPDISTR". This deck represents the 
customer prepared SCP cards to restore the PID tape to disk 
corresponding to steps 1 through 4 in the SYSTEM GENERATION SRL. 
There are several errors in the deck. You should verify the 
control cards to ensure they are punched correctly. 


When you have verified the control cards, contact you lab 
instructor and he will schedule you for machine time. Ensure 
that you are familiar with all aspects of this procedure before 
continuing. | 


NOTE: The PID system on disk should be the same size as 
shown in lab project 20. The individual size of the 
libraries will not correspond to those shown on the 
figure. 


Retain all printouts and control cards from this lab project as 


well as from all subsequent SCP lab projects. The control cards 
will be used again during LP2?. 
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LAB PROJECT 22 - SCP LINK and DELETE 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. ,/ operate the PID system to obtain a DSERV. 


Ze Operate the PID system to punch and display the following 
books. 


- ZeLINKEDIT 
- Z.DELETECL 
- Z.DELETERL 
- Z. DELETESL 
~ Z.PASTCOPY 


3. Prepare the Z books provided on the PID system for 
execution. 


Time required to complete this project averages 1.5 hours. 


Tools, Test Equipment and Documentation 


PID Systen 
System Generation SRL 


Directions 
Display and punch from the procedure library the customer pre- 
pared cards that can be used to display and punch the Z books 
that will be used in lab project 27 to build the system residence 
pack. This procedure is cataloged under the name 'SCPZ-BOOK'. 


1. Configure the Z.FASTCOPY deck to restore from disk to tape. 
You will not use this utility to back up your SCP system 
residence pack because 3330/3340's are not being used. 

IPL the deck to be sure it has been configured correctly. 
The utility run will terminate with the '8F14D INPUT DISK TYPE 
UNSUPPORTED! because a 2314 is being used as input. 
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To create backup during the SCP installation projects the 

OS DUMP/RESTORE utility will be used. Contact your instructor 
for the deck and operating instructions when you need a back- 
up of your SYSRES pack. 


Select the link and catalog books you will use for the 
SCP installation. 
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LAB_ PROJECT 23 - PTF SELECTION Nf 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


ee Select and deblock PTFs from a DOS/VS PTF tape. 


Time required to complete this project averages 1.0 hours. 
Tools, Test Equipment and Documentation 


DOS/VS PTF Tape and Cover Letter 
Work tape for the selected PTFs 


Directions 

Obtain a PTF work tape from your lab instructor. 

Using the BLOCK/DEBLOCK Utility, select (SEL) the PTFs that you 
require (determined during LAB PROJECT 20). 


DO NOT LOSE OR DESTROY THIS TAPE. Ensure that it is labeled with 
your name and its contents. DO NOT back up at this time. 


These selected PTFs will be applied to your DOS/VS system prior 
to the actual SCP Generation during LAB PROJECT 27. 
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LAB_PROJECT 24 - SCP IVP ASSEMBLY 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


/\- Assemble the Installation Verification Procedures using the 
IVPGEN macro with the VERIF=YES option. 


f 2. Delete any unused IVP macros from the source library. 
Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 


Back up tape of your SCP. 


Directions 

From the DOS/VS lab pack (not your SYSRES pack) punch out the 
procedure "SCPIVP'. This is a prepared deck for IVP generation 
and it contains some errors. The IVP will use a disk work space 
of one track on 130 for verification of the disk utilities (input 
and output) and the volume serial number is 111111. 


After the assembly is error free, follow the comments in the 
assembly listing to obtain a printout and delete deck for the 
unused IVP procedures. 


Ensure that you delete the unused IVP procedures from your 
SYSRES pack and not the lab packs. 


Save the 'delete' deck for use during LAB PROJECT 27. 
Prepare the source deck for assembling with VERIFY=NO and include 


the parameter necessary to generate the decks which will delete 
the used IVP books during LAB PROJECT 28. 
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LAB PROJECT 25 - SCP SUPERVISOR GENERATION 


\ 


Objective 


Upon completion of this topic, the student, using the available 
documentation, should be able to: 


1. Given a supervisor generation source deck, correct all 
errors. 


Time required to complete this project averages 3.0 hours. 


BR: LEI CITED LAE AOS SNE ELLIS LES ILL TEE ATED SLE ELE APES 


None listed. 


Directions 
Punch out the user supplied supervisor generation deck (*SCPSUPVR 
in procedure library) and locate all errors. You may do your 
reliminary assemblies of this deck on either your system or the 
ab system. When you obtain your first error free listing, con- 
tact your lab instructor. Do not assemble the supervisor with the 
PRINT GEN option until you have contacted your lab instructor. 
Ensure that the supervisor parameters selected support the environment 
the customer desires. 


Retain the corrected source and JCL (job stream) to catalog the 


supervisor. The supervisor will be cataloged during LAB PROJECT 
27. 
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LAB PROJECT 26 - SCP POWER GENERATION 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


Us Given a POWER generation source deck correct all errors. 
Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 


EEE ASSAY RE AERO PEE CRS ARETE ARE nae Se: eRe gene SDE 


None listed. 


Directions 

Punch out the user supplied POWER source deck (*SCPPOWER' in the 
procedure library) and locate all errors. You may do your 
preliminary assemble on either the lab system or your own. The 
customer has specified that POWER cannot be larger than 34K so 
compute the approximate size of POWER before assembling. 


Do not assemble POWER with the PRINT GEN option until you have 
contacted your lab instructor. 


Insert into the source deck, the necessary statements to catalog 
this program into the core image library as a permanent phase 
entry. The deck will actually be run during LAB PROJECT 27. 
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Objective 


Upon completion of this project, the student, using the available 
documentation should be able to: 


1.  Linkedit and delete IBM components to create a SCP to 
customer specifications. 


Time required to complete this project averages 2.0 hours. 


Tools, Test Equipment and Documentation 


Supervisor source deck and JCL (job stream) from LAB PROJECT 
256 | 
POWER source deck and JCL from LAB PROJECT 26, 
LINKEDIT and DELETE Z books from LAB PROJECT 22. 
OLTs Tape (will be supplied by lab instructor). 
Selected and Deblocked PTF Tape from LAB PROJECT 23. 
PID Tape, Initialize Disk, Dump Restore, and Standard Label 
control cards from LP21. 
@ IVP Delete Deck from LP24. 


Directions 


Using your system, create a basic SCP from the items obtained 
Or created in the previous SCP lab projects. 


Retain ALL printouts from this lab project and make a copy of 
your system on tape when you have finished deleting and link- 
editing. 


PERFORM THE FOLLOWING: 
1. Run Initialize Disk, Dump Restore, and Standard Label con- 


trol cards from LP21. 
2. Apply PTF tape and decks to the PID System 


3. Assemble the Supervisor - obtain a deck but NO 
LISTING. 
4. Perform links and deletes obtained from 'Z* books (include 


supervisor object deck in LNKEDT job stream). 
56 Assemble and catalog POWER (use OPTION NODECK and 
NOLIST). 
6. Execute the IVP delete deck to delete UNUSED IVPs. 
Te Catalog the OLTs (phases) in the core image library. 


' 
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LAB PROJECT 28 - SCP IVP RUN | | © 


Objective 
Upon completion of this project, the student, using the available 
documentation should be able to: 


1. Verify the installation of an SCP using Installation 
Verification procedures. 


Time required to complete this project averages 1.0 hours. 
Tools, Test Equipment and Documentation 


Directions 


Use the SCP source deck from LAB PROJECT 24 to create your 

Stage II IVP deck, as well as the delete decks for the ‘used! 

IVP books. Run the Stage IT deck to verify the installation of 

the SCP (run only the first 2 or 3 procedures and then terminate 

when you feel confident that you understand the IVP operation). @ 


Delete the ‘unused! IVP books. 


LAB PROJECT 29 - SYSRES REALLOCATION 


Objective 


ue Reallocate the system residence pack. 


Time required to complete this project averages 2.0 hours. 
Tools, Test Equipment and Documentation 


Directions 


Create the control cards needed to allocate the SYSRES pack 
libraries to the specifications in lab project 20. Obtain a 
DSERV of the reallocated pack. This is a lengthy operation 
so contact the lab instructor before starting. 
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LAB PROJECT 30 - LIOCS MACROS FOR UNIT RECORD FILES 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Identify and correct source coding and logic errors in a 
program that employs LIOCS UNIT RECORD macros. 


2 Include a logic module from the relocatable library ina 
source program at linkage edit time via the use of an 
INCLUDE statement. 


3. Code the source statements required to separately assemble 
and catalog a logic module to the relocatable library. 


Time required to complete this project averages 2.0 hours. 


Tools, Test Equipment, and Documentation 
DOS/VS Supervisor and I/O Macros 

DOS/VS LIOCS Volume 1 | 

DOS/VS System Control Statements 

DOS/VS Base SCM 2 


Directions to the Student 


Obtain the LP030 source deck from the lab instructor or from the 
PROC library (use // EXEC PSERV and DSPCH LP030). This progran, 
when correctly assembled, linked, and executed, should read data 
cards and list them on the printer. 


An assembly listing of this program (which contains coding and 
logic errors) and an example of expected output are provided 
for your reference in DOS/VS SCM 2. 


Execute the job stream and correct all errors as dictated by 
resultant error messages. 


DU NOT add source statements to the job stream that would generate 
tne required CDMOD and PRMOD logic modules into the program (assume 
that the CDMOD and PRMOD macros are NOT in the source statement 
library and that you would not be able to do this). INSTEAD 
determine the names of the required CDMOD and PRMOD logic modules 
(either from the generated DTF coding or by developing a superset 
name); then cause these modules (contained in the relocatable 
library) to be included in the LP030 program at linkage time via 
the use of the INCLUDE linkage editor statement. 
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NOTE: NO SEPARATE ASSEMBLIES OF LOGIC MODULES ARE REQUIRED TO 
COMPLETE THIS PROJECT. 


Study Questions (Do not answer until 1LP030 has _ been completed) 


1. (True/False) A logic module contained in the relocatable 
library, that has the exact some name as the logic module 
name generated in a DTF expansion, will be automatically 
included om a program at linkage editor time even if the 
logic module macro instruction (XXMOD) was not included 
in the source coding. 


2. Why do you think the ACTION NOAUTO statement was included 
in the LP030 job stream? 


OE a ca aE ED EEE ED CE ED CEE ELND NP CERES ANE NT TD ED ND EDAD SH A AD AED ES LE OS TS NS OS AS A SS SS OS A OD A A ND ETP AD RED ED A ED TE IS TED EN 
EMESIS EASED EP ELIE EINE OELDLPENY SEEPS GT RID CATED TD ELD LSD CED SEED LED EY LID LE: LEY ESD CLG ETE TS CD SLITS AT ETE LD MGS IO LD LLY RELY CLES LG SAE EE NOD CET NMED SELES CASAL SAEED CITED AMET LEE) LG END TOLD SEED NAA CELTS 


SEED EP TELD TES ELS EMD EELS EGE ED ALE LEY ELE GEIL 


NE AILS 


36 If the specific logic module required by a DTF is not in the 
relocatable library, and can not be generated by source coding 
because the required macro is not in the source statement 
library, it may be possible to include a ___ __ module 


from the relo library that will support the required functions 
of the DTF. 


4. What was the name of the logic module that you include in 
the LP030 program to satisfy the required functions of the 
DTFCD? 


Before answering Questions 5 and 6, refer to DOS/VS Supervisor and 
I/O Macros and 'Program, DTF, and Logic Module Assembled Separately’, 


Se If a specific logic module is not in the relocatable library, 
but the required macro that can generate that module is in the 
source statement library, you can separately assemble only the 
desired module and then catalog it to the relocatable library. 


What is the additional parameter that must be specified in 
the source macro instruction that will allow you to do this? 


Which assembler instruction must not be used in the source 
code for a separate assembly? 


EY EP AD CSM EE? ED END AP GEN ASW CEE SEP EED CELI 
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The following job stream will separately assemble a CDMOD 
logic module and punch an output deck that can be used to 
catalog the module to the relocatable library. Supply the 


parameters for the CDMOD macro instruction that will generate 
module IJCFCIWO. 


// EXEC ASSEMBLY 


Ee EE ED ENED eae ED ET 
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© Study Questions Answers 


1. True (this is an automatic system function and can only be 
overridden by the specification of NOAUTO in an ACTION 
or PHASE statement). 


2 The NOAUTO statement was intentionally included to prevent the 
required PRMOD logic module from being AUTOLINKED into the 
program from the relocatable library at linkage editor time. 
This forced you to call module IJDFCPZW into the program via 
the use of the INCLUDE statement. 

3. SUPERSET 

4. IJCFCIWO (this module is a superset of IJCFZIWO). 

Se SEPASNB=YES; START 


6. CONTROL=YES, WORKA=YES, SEPASMB=YES (the defaults for DEVICE=; 
RECFORM=; and TYPEFLE= ARE TAKEN IF THEY ARE NOT SPECIFIED). 
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LAB_ PROJECT 31 - TAPE LABELS | | —_ 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Identify and correct ‘job control statement errors in a job 
stream which linkedits and executes a tape file processing 
progran. 


Time required to complete this project averages 1.0 hour. 


Tools, Test Equipment, and Documentation 
DOS/VS System Control Statements 

DOS/VS Supervisor and I/O Macros 

DOS/VS LIOCS Volumes 1 and 2 

DOS/VS Tape Labels 


ORL TED 


Directions to the Student | | @ 


Obtain the LP031 job stream deck from the lab instructor or from 

the PROC library (use // EXEC PSERV and DSPCH LP031). This job 
stream, when correctly executed, will linkedit and execute a progran 
that reads cards to tape, and then lists them on the line printer 
from tape. 


The program (TAPE) has been previously assembled and cataloged in 
the relocatable library. It is linkedited into the core image 
library by the LP031 job stream via an INCLUDE card (there are no 
errors in TAPE). 


The job stream contains errors which will prevent the program from 
executing correctly. 


Execute the job stream and correct all errors as dictated by resultant 
error messages. 


A program flowchart and an example of expected output are provided 
immediately following this lab project write-up. 


Housekeeping 


Close 
Card and 


Tape Out 


Open 
Card and 


Tape Out 


r Yes 
No | 


Open 


Tape In 
and Print 


Get Card 
Get Tape 


Yes 


Put Tape | | No 


EOJ 


Lab Project 31 - Program Flowchart 
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4/ JOB LPO31 TAPE LABELS 


4/ OPTION LINK 

4/ VOL SYS004, TAPEOUT 

// TPLAB "SAMPLE TAPE 
*0000000 


OUT 12121200010001000101 70150 70150° 
TAPE LABEL® 


4/ TLBL TAPEINe* SAMPLE TAPE OUT®,70/150,121212 520191 


[INCLUDE TAPE 
// EXEC LNKEDT 
// ASSGN SYS004,X*280! 
/f EXEC 
2000909006NUT 
2000000L4BOLT 1-IN 
200000015SCREW 
20000001 9WASHER 
200000022CLIP 
200000024BOLT 1/4-IN 
200000025HAMMER 
200000029PLIERS 
20000003 0F ORK 
200000036CUP 
200000037SHOVEL 
200000039B8RACE 
209090041WASHER 
200000043L 1/2-IN 
200000946T 1/2-IN 
200000051ELBOW 1/2-IN 
200000054TUSE 1/2-IN 
200000056S TOPPER 
200000057G0ER 
20900095 8PLUG 
200000060GLUE-WOOD 1 QT 


EQJ LPO31 


Lab Project 31 - Job Stream and Expected Output 


016987 
134681 
216942 
369876 
369876 
134681 
218990 
647341 
71984173 


379871 | 


643791 
814384 
279696 
848437 
428091 
981111 
116933 
126480 
135790 
663398 
987771 
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160004683 
170002011 
340006138 
660006700 
9000 10843 
7 CQ060000 
012000150 
036000411 
020000266 
016000183 
009000341 
014000363 
400016666 
080011111 
040012121 
090001906 
6000938132 
010000406 
010000381 
080001684 
OO08000113 
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AB_ PROJECT 32 - ESERV FAMILIARIZATION 


o) 


bjectives 


Upon completion of this project, the student using the available 
documentation, should be able to: 


1% Execute the ESERV program (// EXEC ESERV) to cause the de-editing 
and listing of any given macro definition contained in the edited 
sublibrary (E.sublibrary) of the source statement library. 


2 Create and execute a job stream (JCL) that will alter the contents 
of any given E. macro in the source statement library via ADD, 
REP, or DEL control statements of the ESERV progran. 


3. Correctly use the COL, VER, and END control statements of the 
ESERV program when altering or updating an E. macro/ 


4. State the basic difference between macro definitions that are 
~ contained in the MACRO and COPY sublibraries of the DOS/VS source 
statement library. 


Time required to complete this project averages 2.0 hours. 


Tools, Test Equipment, and Documentation 


Guide To The DOS/VS Assembler (GC33-4024) 
OS/VS and DOS/VS Assembler Language (GC33-4010) 


Information for the Student 


This project is intended to familiarize you with the procedures that 
you will be required to know and use when implementing changes to an 
E. macro contained in the source statement library. 


When you have completed this project, you will be expected to know 
only the mechanics of how a statement (or statements) can be added to, 
deleted from, or altered ina E. macro. 


This project does _ not attempt to teach an understanding of the 
"Conditional Assembly Language! (the coding actually contained in a 
macro definition), nor does it teach the structure and internals of 
a macro definition. Information and training on these subjects is 
provided in a postrequisite to this DOS/VS Base course (MACRO 
DEFINITION Student Self/Study Course #40016). 


Information relative to completing this project can be found in the 
"Guide To The DOS/SVS Assembler" under 'DE-EDITING AND UPDATING MACROS: 
ESERV PROGRAM*. 
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In this project you will be working with a sample E. macro that has 


been cataloged in the source statement E. sublibrary (MARCO sublibrary) 


under the name E.CCB32. This cataloged version of E.CCB32 contains 
statements that you must remove, alter, or add to, prior to executing 
a simple assembly that utilizes the E.CCB32 macro definition. 


Edited and de-edited listings of the correct version of E.CCB32 are 
provided for your reference immediately following the answers to the 
study questions for this lab project. 


The source statements for the simple assembly that utilizes E.CCB32 
are contained in the COPY sublibrary (A. sublibrary) of the source 
statement library under the name A.ASM32. You will call these 
statements into the assembly using the assembler COPY instruction. 


Upon completion of this project, you should have obtained an error 
free listing of the 'link and got assembly, and a message printed on 
the line printer that indicates your successful completion of the 
project. | 
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Directions to the Student 


Ve Execute the procedure LP032 (// EXEC PROC=LP032) prior to 
performing any of the following directions (this procedure 
initializes E.CCB32 in the source statement library and condenses 
this library so as to prevent an exhaustion of library space 
as a result of the many catalogs of E.CCB32 by lab groups). 


2 Create and execute the job stream that will de-edit E.CCB32 and 
provide you with a listing of the de-edited macro (refer to 
"Guide to the DOS/VS Assembler. ' 


3. Compare all statements in the de-edited listing of E.CC32_ 
(obtained in step 2) with those in the correct de-edited listing 
of this macro (this listing follows the answers to the study 
questions for this project). 


Any statements in your de-edit listing of E.CCB32 that are not 

exactly the same (or are additional or missing) as those in the 
correct listing must be corrected, deleted, or added to E.CCB32 
by you via the update function of ESERV (refer to ‘Guide to the 
DOS/VS Assembler"). | 


4. Create and execute a job stream to de-edit, update, reassemble, 
and catalog E.CCB32 with the corrections, additions, and deletions 
that you have determined to be necessary in step 3. 


NOTE: Use the Verify (VER) function of ESERV prior to any REP 
or DEL that you may include in your update job stream. 


Se Create and execute a ‘link and got job stream that will call, 
assemble and execute the source statements contained in the COPY 
sublibrary macro A.ASMH32 (do not allow this assembly to be 
cataloged - use // OPTION LINK, NODECK as the only options in your 
job stream). If you wish to see the source statements contained 
in A.ASM32, execute SSERV (//EXEC SSERV) and DSPLY ASM32. 


6. Show your output assembly listing to your instructor and answer 
the study questions for this project. 


Study Questions 


1. Which of the following ESERV control statements causes the punching 
of END and /* cards as the last 2 cards in the output deck from an 
ESERV operation that will be used as input to the assembler? 


PUNCH 
GENCATALS 
END 
GENEND 
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2e 


5. 


Write the ESERV control statement that should be used in an ‘update’ 


job stream to specify that the sequence numbers in the statements 
of a macro definition start in column 73 and extend to column 80. 
CONTROL STATEMENT = 

If the sequence numbers in the statements of a macro definition are 
such that at some point they start over again with a value of zero 
(or some value less than that contained in the previous statement), 
what parameter in a VER, ADD, REP, or DEL control statement must be 
specified to allow identification (and accessing) of a second (or 
third, or fourth, or fifth, etc) macro statement that has the same 
identical sequence number? PARAMETER = 


(True/False) The header statement in a de-edited macro ('MACRO! 
statement) will always have a sequence number of zero (00000000). 


(True/False) BOOKS in the COPY sublibrary (A.sublibrary) of the 


source statement library can also be updated by the ESERV 
progran. 
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Answers 


1. 


2a 


GENEND (This statement is particularly useful when the output 
device is a tape unit instead of a card punch because it 
provides for the writing of the END and /* records on the tape. 
When output is to cards, the END and /* cards could be manually 
punched and placed at the end of the output deck if GENEND had 


not been specified.) 


CONTROL STATEMENT= ) COL 73,8 


PARAMETER= seqnotREL (A REL factor must be attached to the sequence 
number of the statement that has the first highest sequence number 
in the macro expansion. This REL factor acts as a displacement 
from the specified sequence number to the desired statement that 

is to be acted on by the VER, ADD, REP, or DEL. The REL factor 
can be calculated by using the statement numbers on the left side 


of the listing). 


True (Refer to 'Differences Between De-edited Macro Definitions 
and Source Macro Definitions'.) 


False (BOOKS can only be updated by the UPDATE function of the 
MAINT program. Refer to ‘How to Maintain the Copy Library. ") 
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Lab Project 32 - Correct Version of E.CCB32 
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De-editing by ESERV (Par 
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(Z JO L 340d) auasa Aq butyztpe-ag 


I9}3FV CEGDD°A FO UOTSASA FOSaTIOD 


E.CCB32 


ODN OU S WN 


CATALS A.CCR32 


MACRO 


ECCBN CCB32 ESYSXXX ACC WADD sEOP TIONS, ESENSE 
LCLA &CLASS, ENUM 

LCLB &SNS 
LCLC EUNTT,ECCWAD ,ENPTSW,ET 


&T 


* SUPVR 


e NAMOK 


EUNIT 


ECLASS 
&NUM 


eL TRS 


ENUM 
eERR 
ECLASS 
ENUM 
e FND 
ECC WAD 
ECCWAD 
eCCDER 


eCKOPT 
EOPTSW 


EOPTSW 
eOPTER 
e ASMBL 
ESNS 


eR2 
&CCBN 


SETC 


AIF 
MNOTE 
ANOP 
AIF 
ALF 
SETC 
ALF 
AIF 
AIF 
SETA 
SETA 
AGO 
ANOP 
AIF 


SETA 
AIF 
ANOP - 
MNOTE 
SETA 
SETA 
ANOP 
SETC 
AIF 
SETC 
AGO 
ANOP 
MNOTE 
ANOP 
SETC 
ALF 
AIF 
AIF 


SETC 
AGO 


J 


COMMN MACROS - CCB - 5745-SC-SUP — REL. 28.0 


(TTECCBN NE *0°) .NAMOK 
O,*POSSIBLE ERROR - NAME FIELD BLANK® 


(K*ESYSXXX NE 6).ERR 
(*ESYSXXX*(1,3) NE *SYS*).ERR 

*ESYSXXX "(4s 3) 

(*EUNTT® LT "O00" OR "EUNIT* GT *243*).LTRS 
("GUNIT*( 2,1) LT *"O* OR "EUNIT*( 251) GT *9").LERR 
(*EUNIT°(3,1) LT "Of OR "EUNIT*( 3-1) GT *9°).ERR 
l ‘ 

EUNITT 

eFND 


00900000 


06909028 
07100028 


09000928 


10000028 


11000028 
12000028 
13993028 
14000028 
159917028 
16000028 
17009028 
18000028 
19000028 


(*EUNTT® EQ *RORIPTPCHLSTLOGLNKRE SSLBRLBOOORECCLBVISCAT*X21000028 


(3 *E€NUM4#1,3)).2FND 
ENUM41 
(ENUM LE 13).-LTRS 


39°FIRST OPERAND INVALID -— **FFFF** GENERATED® 
255 
255 


ror 
{T°ECCWADD EQ *0*).CCDER 
*E€CCWADD® 

eCKOPT 


Oe*POSSTBLE ERROR IN SECOND OPERAND!® 
‘or 


(T'EOPTIONS EQ *O*).ASMBL 
(K*EOPTIONS LY 4 OR K* €QPTIONS GT 7).0OPTER 


("E€OPTIONS*'(1,2) NE *X*** GR *EOPTIONS* (K*EOPTIONS,1) NEX39000028 . 


evet) ,OPTER 
‘EQPTIONS!# (3,K" &OPTIONS-3) 
o ASMBL 


3y"THIRD OPERAND INVALID — X**0000"* ASSUMED®* 
(TTESENSE NE *0O*) 

(NOT ESNS)-R2 

OD 


RESIOUAL COUNT 
COMMUNICATIONS BYTES 


XL2'*O0* . 
XL2"°E0PTSW* . 


23000028 
24000028 


25000028 
26999028 
27000028 


29000028 
30000028 


31000028 
33000028 


34900028 
36000028 


37000028 
38000028 


41000028 
42000028 
43000028 
45000028 
46900028 
47000028 


00000028 


00010028 


& 
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(7 JO Z 340d) ANaSa Aq bHutytpe-eqg 


*qJ JO UOTSI9A 32D8TI0D - ZE ZOaLOAg qe 
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E.CCB32 


eR1 


XL2*O* . CSW STATUS BYTES 
ALL(ACLASS) . LOGICAL UNIT CLASS 
ALL(ENUM) . LOGICAL UNIT 


-XL1L‘0°% 


AL3(ECCWAD) . CCW ADDRESS 
B*OOESNS.00000° . STATUS BYTE 
AL3(0) . CSW CCW ADDRESS 
(NOT &SNS).R1 

4,EGSENSEOsETESENSE 


01900028 
02000028 
03000028 
140)9928 


21000028 


28009928 
29000028 
30000028 
31000028 


61000028 
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®& T/A PROBLEM 1 


Directions to the Student - The T/A 1 deck may be obtained from the 
lab instructor or punched from the PROC library. The following 
procedure is used to punch T/A decks from the PROC library. 


"7 BXEC PSERV 


; DSPCH TAOO1 
— 
~ ff 


This example will punch T/A 1 from the procedure library and give 
you a printout on SYSLST, with additional instructions and a 
listing of the program. The same format is to be used whenever 
the directions indicate a T/A may be punched from the PROC library. 


The program operation is identical to the program used in Lab 
Project 4. Figures 1 and 2 of Lab Project 4 may be used as 
reference. 


Vs IPL the systen. 

Ze Make a card reader ready with the T/A deck. 

36 Observe the failure indications (for example, how many cards 
were read, console messages, printer output, etc.) 

4. Locate the problen. 

5. Show the lab instructor your solution to eS 


A2341 Wis a nel DASD , ve tere USTO 


Console Log 


Bis ff JOR TAGOT 


‘wee bee oon 


QOATE OLS ALS 74 e CLOCK Tes. aso 


is 2 ela L. oe een 
tits HAS sah LP PWG» poh AT GAG Wii NOT ROVE THIS LAS 
BG // ASSON SYSoOo2,x200E" owke rela vis WAKION tasoor, K'3sp' [ or Dise o¢ 3330 


youn wae gee 


@) 86 8: ag zee “INvaL tt DEVICE aa SYS002 y 


fia he al) ASSEMELER CANNOT CONTINUE 
BG — KE LNREDT 

Qi 249 ve COAG VALLG STORAGE ASSIGNMENT IN FINAL FHASE @ INCUAXS Cad) MISSIN, 
BG OSO2L JOB TAGOL CANCELED GUE TO FROGRAM REQUEST 


BOG EOL) TAQOL 


OATH OF bb 2 24eeC LOO Peel ae TRATION OO 7007 21. 
Bi DOOR ATTA. GO G1, 


Act = 16 208% PHILTAA 
Ae Bega J = INfe Ista homeen Reawrés t1S001/2/3 Yremtd dati & GRID) 35p 
> LED INSET fbn) rt Caan SSK sll pyre KDR 3s - i 
| MP Qywner SST —n—  & [403 OF 
1 PSStaN SYS ann,X —_— 
Inver OY Kee ale INGOT 
1012 
© Ween ahaa tt sia siglautt? console O1F? 
SY SUN —u—? Wo 35%? 
sysood DSO 3p? 


Remrs ie Aifauth b00- 


LikeDT 


T/A PROBLEM 3 : @ 


Indications - Job Control error message issued on the console. 


Directions to the Student - Obtain the T/A 3 deck from the lab 
instructor, or from the PROC library. This program is identical 
to the program used in Lab Project 4. Pigures 1 and 2 of Lab 
Project 4 may be used for reference. 


Kio Af JOB TeeOO8 
NATE OF ALS 24eCLOCK Lee era 
Boo“ ORT LON LINE DUMP e NOTE Cs 
{ a ? 


Ged # WO NOY MOVE TRIS Cant 


tee Tees 


BG FHASE  LFTWG» S4X? 


BRO Af EXEC ASSEMBLY 
Ro EO Tease? 
NATE OL EL SP 4aeC LOC beveoe ale QURATION GO/00/ 41 


BRO Af ASSON SYSTP Ts x? o0oc? 


. 
. 
. 


Ko 4 / AGSSON SYSOOR yx: 


tee ves 


Ba eS 8 eel 


Gin Saat STATERNERNT GLUT OF SEGUERNEE , 
ernsemrsanvena 


i} i’ vee 
« @ 
Leh hs. 


y r. STO UBL 
&) AK trowel Wilt skip. yur 


denim Crrrsi orm. al tearkandd | e 


we 

doy cori SFebped ab STMT = // KE 
gra ford fud3 bee k —~ 
fd Ge 


@ T/A PROBLEM 4 


Indications - Job Control message of UNIT CURRENTLY UNASSIGNABLE 
and no job output. 7 


SRD ERTS RL SEY CEI LES LE CLE ONE LET ILD ATE EY SILLS SELES ETL SIE EELS SRY IE, TL ETT IED EIS 


instructor or the PROC library. Correct the problem using over- 
write statements and verify your solution to the problem by list- 
ing data cards using this progran. 


Console Log 


BO #f JOB TaAGO4 


HATE Of SL/ 74s CLOCK Pees ei ss 
RO 4 / OR TION LINE » NOOR 


Bip FRMASE LP PW $48? GAc? HO NOT MOVE THES CARD 


Bin #f RAED ASSEMBLY 

BO “/ EXEC LAR EDT 

BG “/ ASSGON SYSOO8e x? ooc? . 
BRO Af ASSON SYSOO2sFRINTEE Jat 
BO LAG4a UNTT CURRENT) UNAS S TOMAR . 


iG POE alte Uneot ratty Fystoh er 
fey a | NAT needs Suse 
© nyt amine id it ded 
K he ww antl 
PRIN 15 0 Bt Yr SURY2 to anrcitesrelre 
[ WW, webts SYS 00L init § 
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T/A PROBLEM 5 


Indications - Program loops at execution. 


Sate GERD as SE ED EE SEE COED EE CED GREED ED NED SE 


instructor or the PROC library. Assemble, link edit, and execute 
the program correctly.j The program operation is identical to Lab 
Project 4 Figures 1 and 2 of Lab Project 4 may be used for 
reference. 


Use the following procedure to locate the problen: 


1. IPL the system residence pack (SYSRES). 

2. Make the card reader ready with the T/A deck. 

3s Observe failure symptoms, for example console messages, CPU 
indicators, SYSLST printout, etc. 


NOTE: If you are running under VM it is more difficult to 
determine if your program is looping. A procedure 
that can be used if you suspect you are looping is: 
Issue a LOG command to DOS so your Job Control 
statements will be displayed, use the CP TRACE function 
to find the loop. Do not issue log while CP READ is 
displayed or you will be logged off. Refer to VM 
familiarization project for the procedure. 


_4. Locate the problem. 
a Verify your solution with the lab instructor. 


Eo Af JOR PAseOO 


WATE OLSS1/74eCLOCK Ler easag 

BG 7 / OF TON WN » DUMP » NEED 

BG FHASE  LETWO»sS+x'éag? no NOT MOVE THIS Cari 
/f EXEQ ASSEMBLY 

BG // EXEC LAKEDT 

BG // ASSGN SYSLPT sx? o0C? 

BG // ASSGN SYSOOS» xT OOE? SK 

ek 


Moe Ae 


S7LBLOOO ogbBO730 Psa 
ate ctae TROT 


eel gee 


Prey a es ee a tee ed Loe bee 
C7 ALL WLIO #4 oo p cw 
rte oO Dear Ae, 


(NOTE: There are more instructions in the loop.) 
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& T/A_ PROBLEM 6 


Indications - Error message on the console at execute time and a 
system abort. 


instructor or the PROC library. Assemble, link edit, and execute 
the program correctly. Figure 1 is the flowchart of the program 
and Figure 2 is the correct output. Verify your solution with 
the lab instructor. 


Directions to the Student - Obtain the T/A 6 deck from the lab 


Console Log 


Bi “fF JOB TAGOS 


NATE OLSALS Sao CLOCK Levee eae 


Ris 47 OF TON LIN » OUMP » NOTECE 


woe ‘ese 


HG “/ EXEC ASSEMBLY 
BG ¢/ EXEC LNREDT 
BG // EXEC 


Bip OFS ST  & THVAL SEEK SY SRE Ss: 7 AG 


Ciobbe Ge? DOOR OGOCOOR GOO000 CCR@G8OGG4 Sh=Go0aCKa000049 
Sy isos bE egg kG 


ete res 


Unavopit 


60.00 Ol 8 0004 


o'r 234s 
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Read 


Read 3 
Records 
from 

SYSRES 


... Read 3 Disk Records from Cylinder 
198, Head 09, Records 1, 2 and 3 


Printer 


Print the 
3 Records 
from 
Disk 


[FE 121908) 
Figure 1- T/A 6 Flowchart 
// EXEC 
THIS IS RECORD NUMBER ONE ISN'T IT A LOT OF FUN. 
THIS IS RECORD NUMBER TWO ONLY ONE MORE RECORD TO DO. 
THIS IS RECORD NUMBER THREE AND CONGRATULATIONS TO THEE. WHOOPEE 


Figure 2 - T/A 6 Printer Output 
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T/A PROBLEM 7 


Indications - Error message on the console and a system abort. 


Directions to the Student - Obtain the T/A 7 deck from the lab 
instructor or the PROC library. Assemble, link edit, and execute 
the program correctly. Figure 1 is the flowchart of the program 
and Figure 2 is the expected output. Verify your solution with 
the lab instructor. 


BRO “/ JOR TAQG? 
OATE OLS SIS 74 CLOCk Le/seg/e4 
BO 4/7 OPTION LINK » UMP » NODECK 
BO “/ EXEC ASSEMELY 
BO “7 EXEG LAKEDT 
BO // EXEC 
BO OFZ2T JOB TAGO? CANCELED TUE TO READING FAST /#& STATEMENT 
BO EO TAQO? 
QATE OLS 31/749 ClOCk Le/S3/1 6s DURATION OO/O38/53 
BO LCOOA ATTN. O OC, 
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Printer 


Setup 
Printer 
\/O Area 


Figure 1 - T/A 7 Flowchart 


Jf EXEC 

SSSESEEHEERERESEEESD DATA CARD 
ECHEHKEKTHEREREKEEKE NATA CARD 
KEEKEEKEREEESESEEERE DATA CARD 
CEKSEKEREKEEEEEEEEEE DATA CARO 
CHRSEKSEKRERER ESTEE EEEE DATA CARO 
CHKKEKEREREEHEE EEE DATA CARO 


Figure 2 - T/A 7 Printer Output 


NUMBER 
NUMBER 
NUMBER 
NUMRER 
NUMBER 
NUMBER 
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Ow Sf WR we) 


EQJ 


[FE 121909] 


SKEKESKESKEKKEKEKESEREKSEKSE EE 
SEKEKEKKSERSESKSESCESEKEKRERKRESE 
KESKEKKKSSEKSEKKEKSEKEKEKES 
KTKSEKSEKAKSETEKKEKEKKEKEEEKE 
SEREEKEKEKSSKEKEKEREKVEKES 
KKEKKEKKSKEKEEEEEEKEEKKESCESRS 


@ TZA_PROBLES 8 


Indications - Printer page fails to overflow. 


Directions to the Student - Obtain the T/A 8 deck from the lab 

instructor or from the PROC library. Assemble, link edit, and 

execute the program correctly. Figure 1 is a flowchart of the 

program and Figure 2 is the expected output. Verify your solu- 
tion to the problem with the lab instructor. See NOTES. 


Console Log 


RO // JOB TAOQO 

OATH OL 3L/ 749 ClOCk 12/33/46 
BG // OFTION LONK » DUMP 
BG // EXEC ASSEMBLY 
RG OFOGA TNTERY REQ SYSFCH=O0T 
Bi #/ EXEC LANKEDT 
BG #/ EXEC 
RG EOI TAQO8 

DATE O1/ 31/749 CLOCK 12/46/39 eTURATION GO/14/50 
BO LOCOORM ATTN, O OC, | 
BG | 


NOTE 1: THIS T/A SHOULD BE EXECUTED ON A STAND-ALONE SYSTEM AND 
NOT UNDER VM 


NOTE 2: BEFORE EXECUTING THE T/A 8 DECK, DO AN //EXEC BUGO1 AT 

; THE CONSOLE TO PREVENT AN UNNECESSARY DUMP OF THE 
SUPERVISOR. ENSURE THAT THE PROCEDURE *LOWBUGS*' HAS 
BEEN EXECUTED PRIOR TO EXECUTING BUGO1. 
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Yes 


EOJ 


Printer 


Channel 12 
on Carriage Tape 


[FE 121906] 


Figure 1- T/A 8 Flowchart 
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19 EAR. SNES 


© SHESCSEHSEKSESKEKESESE EE . DATA CARD NUMBER 


l SEREEERESEKREEEESEEEESESEEEE 
$4S6$4EHESEEEEESEKEK DATA CARD NUMBER 2 SHEKSECESESESSKEREKEEEESSE 
SHSEEKEKEREKEE SERED DATA CARD NUMBER 3 SKEKEKCEKSEKSECESEERKESEESEKES 
ESEKKEKSEKESEKESEEKEE DATA CARD NUMBER 4 SEEEKKEKSKESEKSEEKESEKESEEE 
SHSECETKEEHESEEEEESE DATA CARD NUMBER 5 KCTSECSSESKESESEESHEROSESKE ES 
TESTES ESSETESERESEESE DATA CARO NUMBER 6 SEKOKSESEEKEEEESEKEESSSEHEES 
$9098 ESESEEKEEEEEE DATA CARD NUMBER 7 EEESCSECKESERESEERESEESEEES 
SHSKCKEECERETESEBESS DATA CARD NUMBER 8 SEEKSESKKKEKESESEKSSSESSESES 
SEEEEEHSEEESEERECEEEE DATA CARD NUMBER 9 SHEKEKEKRKEKESKEKEKES SESE SE 
$OO9E$ SE 4$48EERESESE DATA CARO NUMBER 10 SHEKSEKEHSEEESSEESEKEEESE 
SKEECKSEKESEKRESESE EE DATA CARD NUMBER 11 BEEEEEEEERERBESESEESEESESE 
SESCKESESESSEREEKERSE DATA CARD NUMBER 12 THEKHKSKKERESEKEKEERERESES 
SERESEKRESEESEEEEE EE DATA CARD NUMBER 13 £EE$EE46E4EEEKEESHRESEEESEEE 
THESCKEEKEKEEESE HEED DATA CARD NUMBER 14 SEEREKSKEKSESSSEKESSEHEKE KES 
CHESCESKEKESEESEEEREE DATA CARD NUMBER L5 SHEREEKSKHKKKERHAKSEERERSES 
EKEKEEKERKESESEEERES DATA CARD NUMBER 16 KHCAHESEKERESSESKEESESEES 
CHECREEESEEEESEREEE DATA CARD NUMBER 17 SEKEKESEHEEEKEREKESEEEKEE 
CEKKAEKSKKERES ESEEE DATA CARD NUMBER 18 SHEKETKKEKEKEREREKESEESE 
COES$EESRESEEEKERERED DATA CARD NUMBER 19 KCECEKEASKKAKEKKEKESESESEREE 
THKEKEEKEREKEKEEEEE DATA CARD NUMBER 20 SKEKKEKSKEREKKEKERESESEEES 
$ESEEEEEEEEERESEEEE OATA CARO NUMBER 21 SCKEKHEKEKEEKKESKSEERESEKESE 
CHEEREKESEEEEESHEEKE DATA CARD NUMBER 22 KKEKKKKEKKEKSEEEKESEESEEEE 
THKEREKEEETEKEEEE EE DATA CARD NUMBER 23 | KCEESEKEKKSEKEEKEKRKEEKKKE SES 
EREKSEKEESSEREKEREEEE DATA CARD NUMBER 24 EHESCEKEREEKEESKEEESEESEEEDS 
KEEKGCKEKEESESESEKEE ES DATA CARO NUMBER 25 THEKESKEKEKAKSSEEKSESERSEKES 
SHKEESKSEKEKESERESEESRSE DATA CARD NUMBER 26 EESCEKEKEKEKEREEESERKESERSE € 
KEEKEEEEEEERESEESEES DATA CARD NUMBER 27 CSEKKECKKEKREKEREREEHKERERE 
CHEESES KESEREEEEEEEEEK DATA CARO NUMBER 28 KKKEEKEKEKKEKEEKEKRESEESS 
ETEKKEKEEREEEEECEEEEK DATA CARD NUMBER 29 EHEKKKEKKKESCSEEKEREEESESE 
SHKEKERERESEREEEEEE DATA CARD NUMBER 30 THKHEKESESEREKESHESEESERES 
EHKHKEKEEEEKESESETRE DATA CARD NUMBER 31 KRESKEREKERERERESEEEKEREE 
CREKKEESEKVEREEESESE DATA CARD NUMBER 32 CHREKKKAEKSEEEKEEESESESEEES 

© KEKEESEEKERERERES EE DATA CARD NUMBER 33 KTARECKKEKKEKKEKEKEERESEED 
| EHECEKECKEESEESEREE DATA CARD NUMBER 34 EKESESCEEKEKEEKERECKEEESESS 
CHEEKS KKEKEEKEEEEEEES DATA CARD NUMBER 35 SELHSCEKEREREES EEE EEEEESS 
TFEKEEESCERESESKESED DATA CARD NUMBER 36 CEEKESKKKEKRSESKEEKEEKEKESEKEEE 
ESEKEEKEREKERETEEEE DATA CARD NUMBER 37 KEKRKKEKEKKKSEKSEEESKESEHKEERES 
EKEKEKERKEKKESHEKED DATA CARD NUMBER 38 SKESEKRKEKEKSEEKESEESEEERED 
KEKECKEEEEEESEEESESD | DATA CARD NUMBER 39 EREKKEKKKEKEKEKREEEEKEEESEE 
KECEEEEEREEEEEE EE EE DATA CARD NUMBER 40. THEKKEKEKEEESEEKEREEEEESS 
KEKSESKEEESEEEREERES DATA CARD NUMBER 41 KERECKEKESERRESKESCESERSE KES 
€HEEEEKEEREESEEEEEDEE DATA CARD NUMBER 42 TEESCSCHKEKKESSEEESEKSEKKERED 
CEECKEEEKERESEEEEEE EE DATA CARD NUMBER 43 KEKSKHKEKEKSKESEKEESE SEEKS 
ESKEKKEEEKEESERESE EE DATA CARD NUMBER 44 THKEKSEKAKKEREKEKEREREEKS 
RECSKSKERERAEKESEEE DATA CARD NUMBER 45 KEKSKEKKESKKEERESSEEE SERED 
£TKOEEEEEESESEKEEEEEE DATA CARD NUMBER 46 EHEKESESCHKESKESEKEESESEKEKEK 
TECKKEREESESEEEEE Et DATA CARD NUMBER 47 KRECKKKKEEKEKEKES SEE EEEEE 
CEES EESEEEEEEESEEES DATA CARD NUMBER 48 SEKERESEEEKREEESERESEREE 
SHEKEREEKEKESEREEESE DATA CARD NUMBER 49 KHEKEKEKRESKKEKEKEKESESES 
EKECKEKEEESCEESEREEE DATA CARD NUMBER 50 SHEKRECAERKEEKSEEKESEKEKEEEEE 
KEKKEKERSEEESERESEEE DATA CARD NUMBER Sl RHEEREKKSEREKE EEKERESESESES 
ESEKKESEKEEEREREE SE DATA CARD NUMBER 52 CHEKSEKEKKEKEKEKEEKEESEEES 
ESECKEEKEEEREERESE ED DATA CARD NUMBER 53 CKECEEEKEKESKEEEKECEREEEE 
SREEKKEEEEEEEEEEEEE DATA CARD NUMBER 54 KKEEREEHKEREEESHESKSE SEES E 
£EOECEEEEEERESEEEEE DATA CARD NUMBER 55 SERKKKKSSHSESEKE SHES ESSE 
€HESEEEEEEKEREEES ES DATA CARD NUMBER 56 BREESE EEESEEEEEEE 
TCREKSEKEEEEEEEEEEEDE | DATA CARD NUMBER 57 EEEEEKEEEEEEEREEEESEEEE 
EHECEKESKESEEEERESE DATA CARD NUMBER 58 FRERESCKEKESE SE KEESEKESEEEES 
KEKE ERESEEEEERERE DATA CARD NUMBER 59 CXEECEESTKEESEKERESESESESE 
KSCSEKCESEKEESSESE KEKE EE DATA CARO NUMBER 60 €£EEEEESEEEEESESEHEEEESESEE 


(FE 104945) 
Figure 2 - T/A 8 Printout (Part 1 of 2) 
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Seeeeeosesseoooeess 
SHSSOSSSSesesessses 
Seesessesecessesess 
SCHesoreseeseseesesse 
Seseesssessesesesecs 
SSeeeesesssessseses 
SSESHSESHSSESRSESSESSEEE 
Steseeseseesessesss 
SHSSseesessesessessssese 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


Caro 
CarOd 
CARD 
CARO 
CARO 
CarROd 
CARD 
CARO 
CARO 


NUMBER 61 
NUMBER 62 
NUMBER 63 
NUMBER 64 
NUMBER 65 
NUMBER 66 
NUMBER 67 
NUMBER 68 
NUMBER 69 


Figure 2 - T/A 8 Printout (Part 2 of 2) 
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SSTSSSSSSSESSSSSHESHSSSSSSS 
SSSHSSSESSSESSSSSSESSSSSSSS 
SSSSSSSSSSSSSSSSSVESCSSSS 
SSHSSSSSSSESSESSSESSSSSSSSSS 
SSSSSHSHSSSHSSSSSSSSSSSSEESS 
SSSSHSSSSSHSESSSESHSVSSSVSs 
SSSSESSSSSSEHSSESSSSESSSSESESY 
SSSHSSSSESSCSSSSSSSSSESSsss 
SSSSSHSSSESSSSSSSSSESESEES 


T/A PROBLEM 9 
Indications - Error message on the console and a system abort. 


Directions to the Student ~- Obtain the T/A 9 deck from the lab 
instructor or the PROC library. Assemble, link edit, and execute 
the program correctly. Figure 1 is a flowchart and Figure 2 is 
the correct output. Verify your solution to the problem with the 
lab instructor. See NOTE. 


Console Log 


BO “f JR TAGOY 

QATE OLS EL/74eClOCk Lesage 
BO // OPTION LINK » DUMP » NODECK 
BG #/ EXEC ASSEMBLY 
BG “ff EXEC LANRKEDT 
BO 4 EXEC 
BG OFS4T 0 FROG CHECK SYSLST=G0E 

COSW] TB LOOBOLFO00 200600 COR=G8G170 


BG OF FET Je TAGOY CANCELED CUE TO T/0 ERROR 


NOTE: BEFORE EXECUTING THE T/A 9 DECK, DO AN // EXEC BUGO1 AT THE 
CONSOLE TO PREVENT AN UNNECESSARY DUMP OF THE SUPERVISOR. 
ENSURE THAT THE PROCEDURE 'LOWBUGS!' HAS BEEN EXECUTED 
PRIOR TO EXECUTING BUGO1. 
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Printer 


Figure 1- T/A 9 Flowchart 


44 EXEC 
SHSHSSEERESESEEEEEEEE 


seeeeesesteoneneces 
Sheseeneseeeseeeees 
SHESRESETERESEESEES 
Heeeeetettegeseeees 


SESSCSKESSHEEESTESSEEES 


Figure 2 - T/A 9 Printer Output 


Print a 
Line and 
Space 3 


DATA 


DATA 


DATA 


DATA 


DATA 


DATA 


CARD 


CARD 


CarO 


CARD 


CARD 


Card 


NUMBER 


NUMBER 


NUMBER 


NUMBER 


NUMBER 


NUMBER 
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(FE 121905] 


SHSESESSLEKLSHESSRESSSESESS 


SECKESESKSESSSESEESSESSESESS 


STLSEKSETSEESEKSES VE KESESESSSESSE 


TE eeeeSSERSEESESESEESEEESE 


EEKEEKEKEKEEEEEEKREESESEES 


SSESKSESKSKSKCESHESESSEKSEESSESS 


T/A PROBLEM 10 


Indications ~ Improper output on the printer. The printer fails 
to space 3 between print lines. 


Directions to the Student - Obtain the T/A 10 deck from the lab 
instructor or the PROC library. Assemble, link edit, and execute 
the program correctly. Figure 1 is a flowchart of the program 
and Figure 2 is the correct output. Verify your solution with the 
lab instructor. Before attempting to run the T/A 10 deck, do a 
// Exec BUGOT at the console to prevent an unneeded dump of the 


supervisor. Ensure that the procedure 'LOWBUGS' has been executed prior 


to executing BUGO1. | 


Console Log 


RO #/ JOB TAGLO 

QATE OL/ 81/749 CLOCK Tesh £40. 
RO 4#/ OPTION LINK» QUMPF » NODECKR 
BGO // EXEC ASSEMBLY 
BG “/ EXEC LANKREDT 
BO #/ EXEC 


RG EG TAOTS 


QATE OF 41/749 CLOCK Le/ehe/ a4 eo CURATION OO/00/753 
CO LCOOA ATTN. O OL, 
BG 3 
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Printer 


Printa 


Figure 1 - T/A 10 Flowchart 


44 EXEC 
SHEESH HEKESEESEEEESE 


SS$SCCHHESEESE Cegegeces 


SSSSESSTEKEKESESEEKSES 


LEE SESESE LETTE E SE SS 


SSHSESESHVESEV gees eeeese 


SHESSSESESCSRSESHTASSSESKESE 


DATA 


DATA 


DATA 


DATA 


DATA 


DATA 


Line and 
Space 3 


CARD 


CARD 


CARO 


CARD 


CARD 


CarO 


Figure 2 - T/A 10 Printer Output 


NUMBER 


NUMBER 


NUMBER 


NUMBER 


NUMBER 


NUMBER 


CESERESTESSESES ESSE SES ES 
eTTTTTTiiTitittt tt TT tk 
Ser everes eee er tt esecres. 
SE SKeTTHESSESESSESSESSEEE 
REECKECSEHSHSEHEEESEEE EES 


SSSHSESSSSESSKEKKEEKSEEEESS 


| ROBL 11 


Indications - Error message on the console and printer and a systen 
abort. 


Directions to the Student - Obtain the T/A 11 deck from the lab 
instructor or the PROC library. Assemble, link edit, and execute 
the program correctly. Figure 1 is a flowchart of the progran 
and Figure 2 is the correct output. Verify your solution with 
the lab instructor. Before attempting to run the T/A 11 deck, 

do a // EXEC BUGO1 at the console to prevent an unneeded dump 

of the supervisor. Ensure that the procedure "LOWBUGS' has been 
executed prior to executing BUGO1. 


RG // JOB TAOLL 

HATE OL/31/74y9CLOCK 12/53/05 
BG // OPTION LINK sy DUMP» NOUECK 
RG // EXEC 
BG // EXEC 
BO // EXEC 
BG OP771 JOB TAOLL = CANCELED GUE TO INVALID AnuRESsS 
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Figure 1 - T/A 11 
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Figure 2 - T/A 11 Printer Output 


NUMBER 
NUMBER 
NUMBER 
NUMBER 
NUMBER 
NUMBER 


306 


Own & WwW A pe 


EOJ 


EOJ 


(FE 121904] 


SESESKSEKKSSEKSESKSEKSETCES ES 
SEKETKESCSEKEKKEKKSEKESKREKS 
SEESCKSELKSKSKEKSSHKEKSESEEES 
SKEKSEKKSKEKSESEKSEKAHEKRVSE SESE 
SHSSKSESSKKASEEKEKKKAKHKSESKESES 
EKCEKERSKARECKEKEEKKSEESESSS 


T/A PROBLEM 12 


Indications - After the message F102I OLTS RUNNING prints on the 
console a program check occurs at location O147FF. (Specification 
exception). 


Directions to the Student - Type in // EXEC BUG12 on the console. 
Assign SYS005 to the printer and initialize the OLTEP program to run 
the 1403G test. Use PDAID Fetch/Load Trace to assist in trouble — 
analysis. Notify your lab instructor when you have located the 
altered code. Ensure that the procedure 'LOWBUGS' has been executed 
prior to ae of BUGO1. 
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-~ Message E226I OLTEP TERMINATED - CONSOLE KEYBOARD 


Directions to the Student - Type in // EXEC BUG13 on the console. 


Attempt to initialize OLTEP to run the 1403G 


Assign SYS005 to the printer before initializing OLTEP. 
Notify your lab 


Fetch/Load Trace to assist in trouble analysis. 
instructor when you have located the froblen. 
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ACT PRCT 


(cripple print) test. 


Use PDAID 


PROM WROTE 


T/A_ PROBLEM 14 


Indications ~- The message E108I INVALID ENTRY IN DEV FLD OOE prints 
on the console and the ENTER DEV/TEST/OPT message reprints. 


Directions to the Student - Type in // EXEC BUG14 on the console. 
Assign SYS005 to the printer. Attempt to initialize OLTEP to run the 
1403G test. Use PDAID Fetch/Load Trace to assist in trouble analysis. 
Notify your lab instructor when you have located the problem. 
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T/A PROBLEM 15 


Indications - The message 0110A GIVE IPL CONTROL COMMANDS prints 
continuously on SYSLOG. 


When "requested, re-IPL the default DOS supervisor to have the bug 
show up. 
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@ T/A PROBLEM 16 


Indications - The message 0I18A SET COMMAND NOT GIVEN is printed 
even though the normal SET command has been entered. 


Directions to the Student - Type in // EXEC BUG16 on the console. 
When requested, re-IPL the default DOS supervisor and enter the 
IPL commands. 


Console Log 
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T/A PROBLEM 17 ® 


Indications - 0I111A PREVIOUS COMMAND INVALID message is printed 
whenever a DPD command is entered without operands. 


Directions to the Student - Type in // EXEC BUG17 on the console. 
When requested, re-IPL the default DOS supervisor and enter the 
IPL commands SET and DPD. 
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T/A PROBLEM 18 


Indications - When a job control statement contains more than three 
characters in the first or second operand, an error message of 1S02D 
INVALID STATEMENT is issued. 


Directions to the Student - Type in // EXEC BUG18 on the console. 
After the system is bugged, enter the following commands: 


// JOB YOURNAME 
// ASSGN SYS005,X'OOE! 
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T/A PROBLEM 19 @ 
Indications - When an ASSGN statement is encountered, the message 

1SO04D INVALID STATEMENT is issued. 

Directions to the Student - Type in // EXEC BUG19 on the console. ) 


After the system is bugged, enter the following commands: 


// JOB YOURNAME 
// &SSGN SYS005,X*O0E! (0B 
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T/A_PROBLEN 20 


dications - When any Job Control JOB statement is encountered, 
the error fiessage 1503) INVALID STATEMENT is issued. 


Directions to the_ _Student - Type in // EXEC BUG20 on the console. 
After the system is bugged, enter the following commands: 


// JOB YOURNAME 


Console. Loc 
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VATE GIs se P4eClLGce Paste eae 
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T/A PROBLEM 21 


Indications - Gives program check in the BG savearea when trying 
to process an EXEC statement. 


Directions to the Student - Type in // EXEC BUG21 on the console. 
After the system is bugged, enter the following commands: 


// JOB YOURNAME 
// ASSGN SYS005,X'00E! 
// EXEC DSERV 
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Indications - Job is canceled with the message OSO4I ILLEGAL SVC - 
HEX LOCATION nnnnnn - SVC CODE 42. 


Directions to the Student - Type in // EXEC BUG22 on the console. 
When requested, re-IPL the default supervisor and enter the follow- 
ing commands: 


// JOB YOURNAME 


// EXEC TESTMAC | LNTSVC ee 
RIK 
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T/A PROBLEM 23 


Indications - The system enters a ‘Hard Wait state during IPL. 


Directions to the Student - Type in // EXEC BUG23 on the console. 
When requested, 
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re-IPL the default supervisor. 
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@ T/A PROBLEM 24 


Indications - OI116A NO PUB GIVEN FOR SYSLOG. When the student 
tries to add the PUB for SYSLOG, he receives the following message 
OI13A CANNOT ADD PUB —- INSUFFICIENT TABLE SPACE. 
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When requested, re-IPL the default supervisor. 
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T/A PROBLEM 25 @ 


Indications - System enters a soft wait state during IPL. 


Directions to the Student - Type in // EXEC BUG25 on the console. 
When requested, re-IPL the default supervisor. 
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~ System enters wait state when end key depressed for 
ne5sag6 RE DY FOR COMMUNICATIONS. 


Directions ‘to the Student - Type in // EXEC BUG26 on the console. 
When requested, “re=IPL the default supervisor normally and press 
the END key in response to the READY FOR COMMUNICATIONS message. 
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// EXEC BUG27 on the console. 
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Indications - System enters a wait state during IPL. 


T/A PROBLEM 27 
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T/A PROBLEM 28 


Indications - 1) System enters a hardwait condition during exe- 
cution of the BGV program. 2) Hardwait code is stored in GPR11 (RB). 


Directions to the Student - Type in // EXEC BUG28 on the console. 
When requested, re-IPL the default supervisor and enter the following 


commands to Job Control/Attn. ALLOCR F1R=130K, STOP BG, BATCH F1, 
exec the program VSSLOLEV in real mode in F1, giving it a wait time 
interval of 1, restart BG and exec the program VSSCP03 in BGV. 
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segs 


e T/A PROBLEM 29 


Indications - 1) System enters a hardwait condition during rev. 
2) An addressing program interruption is indicated. 


Directions to the Student - Type in // EXEC BUG29 on the. ional: 
When requested, re-IPL the default supervisor. 


Console Log 
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T/A PROBLEM 30 


Indications - The system enters into a LOOP. 


Directions to the Student - Type in // EXEC BUG30 
When requested, re-IPL the default supervisor. 


Console Log 
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T/A PROBLEM 31 


Indications - When the // ASSGN SYS005,x'00C" Job Control statement 
is processed, a message is issued: 1A43D INVALID LOGICAL UNIT 
SPECIFICATION 


Directions to the Student - Type in // EXEC BUG 31 on the console. 
When requested, re-IPL the default supervisor and enter the 
following commands: 


// JOB YOURNAME 
// ¥SSGN SYS005,x"00C! 


Console Log 
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T/A PROBLEM 32 
Indications - System enters a soft wait state. 


Directions to the Student - Type in // EXEC BUG32 on the console. 


When reguested, 
following commands: 


// JOB YOURNAME 


Console Log 
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re-IPL the default supervisor and enter the 
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T/A_PROBLEM 36 


Indications - The first time an error occurs on the 2540R, the 
message 0P27 UNKNOWN DEVICE S¥Snnn=00C is issued. 


Directions to t d 


- Type in // EXEC BUG36 on the console. 


When the READY FOR COMMUNICATIONS message is returned, press the 


END Key while the SYSRDR device is not ready. 


Console Log 
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T/A PROBLEM 37 ! 
Indications - System enters a soft wait state. 


Directions to the Student - Type in // EXEC BUG37 on the console. 
When requested, re~-IPL the default supervisor and enter the following 
commands: 


// JOB YOURNAME 


Console Log 
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T/A PROBLEM 38 


Indications - No output when the EDIT option source is selected by 


depressing the End Key in response to msg. 3E11D. 


Directions to the Student - Type in // EXEC BUG38 on the console. 


when the READY FOR COMMUNICATIONS is returned, enter the 
commands: 


// JOB YOURNAME 
// BXEC EREP 


Console Log 
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following 


T/A PROBLEM 39 


Indications - The system enters a hard wait state. 
Directions to the Student - Type in // EXEC BUG39 on the console. 


When reguested, re-IPL the default supervisor and press the 
EOB/END key with the card reader not ready. 


Console Log 
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TZA_ PROBLEM 40 

Indications - The systema enters a hard wait state. 
Directions to the Student - Type in // EXEC BUG4O on the console. 
When reguested, re-IPL the default supervisor, mount a scratch 


tape unit and enter the following commands: 


// JOB YOURNAME 
// BXEC DITTO 


Using the DITTO program, enter the command 'FSF' for the tape 
address where the scratch tape is mounted. 
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T/A PROBLEM 42 
Indications - System enters a hard wait state during IPL. 


Directions to the Student - Type in // EXEC BUG42 on the console. 
When requested, re-IPL the default supervisor. 


Console Log 
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Directions to the Student - Type in // EXEC BUG4&4 on the console. 


When requested, re-IPL the default supervisor. 


Console Log 
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T/A PROBLEM 45 


Indications - The job is canceled with the message: 


OP77I JOBXXXXXXXX CANCELED DUE TO INVALID ADDRESS. 


When requested, re-IPL the default supervisor and enter the 


following commands: 
ASSGN SYSIN,UA 
ASSGN SYSLST,UA 
STOP 
(Request Key) 
BATCH F1 
ASSGN SYSIN,X*00C* 
ASSGN SYSLST,X*'OOE!® 
// JOB YOURNAME 
// EXEC PROC=SUPERBUG 


Console Log 
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ons - The job is canceled with thé message: 
XXXXXKX CANCELED DUE TO INVALID ADDRESS. 
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T/A PROBLEM 47 


Indications - An '"END* in response to the READY FOR COMMUNICATIONS 
message with the card reader not ready causes the system to go 
into a wait state. - When the Reguest Key is depressed the system 
enters into a loop. 


Directions to the Student - Type in // EXEC BUG47 on the console. 
When requested, re-IPL the default supervisor and depress the End 
Key in response to the 1I00A message. Press the Request Key. Do 
not make the card reader ready. 


Console Log 
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T/A_PROBLEM 48 


a protection exception program check. 


Directions to the Student - Type in // EXEC BUG48 on the console. 


When requested, re-IPL the default supervisor and enter the 
following commands: 

// EXEC PROC=SDL1 

/& 

// JOB YOURNAME 

// EXEC PROC=TAOUY 
* If at IPL the message 1TO0A is printed, respond with URES. 
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ISI OIOIOLO TOTS 


Indications - The program running in the BG partition cancels with 


T/A PROBLEM 49 


Indications - The program is canceled due to an operation exception 
program check. 


Directions to the Student - Type in // EXEC BUG49 on the console. 


When requested, re-IPL the default supervisor and enter the follow- 


ing 


commands in sequence: 
// EXEC PROC=SDL 
/& 
// JOB YOURNAME 
// EXEC DSERV 


* If at IPL the message 1TO0OA is printed, respond with 'REJ'. 


Console Log 
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TZA_ PROBLEM 51 


Indications - The systen enters into a loop during IPL. 


Directions to the Student - Type in // EXEC BUGO1 on the console. 
When requested, re-IPL the default supervisor... 


Ensure that the 


procedure ‘HIGHBUGS' has been executed prior to execution of this T/A. 


Console Log 
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There are more instructions 
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T/A PROBLEM 52 | | |  @6@© 
Indications - System enters into a loop. | 


Directions to the Student - Type in // EXEC BUGO2 on the console. 


re 


When requested, I re-IPL the default supervisor. 


Console Log 
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(NOTE: There are more instructions in the loop.) 
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T/A_ PROBLEM 54 


Indications - 1) System enters a soft wait condition 
of the BGV program. 2) No task is ready to run. 


Directions to the Student - Type in // EXEC BUGO4 on 
When requested, re-IPL the default supervisor. 


Console Log 
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_ T/A PROBLEM 55 


Indications - The program issues a DUMP macro due to an error condition 
detected while using the page manager services. 


Directions _ to the Student - Type in // EXEC BUGO5 on the console. 
When requested, re-IPL the default supervisor and enter the follow- 
ing commands: 


// JOB YOURNAME 
ALLOCR BGR=100K 
// EXEC TESTMAC, SIZE=4K 
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1) System dump and message OP77I printed on console 
- 2) Message 1IOOA never issued. 
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Directions to the Student - Type in // EXEC BUGO6 on the console. 
When requested, re-IPL the default supervisor. 


Console Log 
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T/A PROBLEM 57 


Indications ~- 1) System enters a softwait condition following 


an attempt to execute an F1 program in REAL mode. 2) BGV program 
does not execute. 


Directions to the Student - Type in // EXEC BUGO7 on the console. 
When requested, re-IPL the default supervisor and enter the commands 
indicated by the Console Log. 


Console _Log 
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ED ED SD ED TD ED > 


Directions to the Student - Type in // EXEC BUGO8 on the console. 
When requested, re-IPL the default Supervisor and enter the following 
command sequence: 


Initialize SDAID with a space of 400K. Batch F1V and execute 
VSSPMO1. Then execute VSSPM01 in BGV and once again in F1 
(cefer to Console Log). 


Console Log 
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@ PZA_ PROBLEM 59 


Indications ~ System enters a loop while executing a program in 
the Flv partition. 


Directions. to the Student - Type in // EXEC BUGO9 on the console. 
When requested, re-IPL the default supervisor and enter the following 
commands as indicated on the Console Log. 
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(NOTE: There are more instructions in the loop.) 
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PROBLEM 60 ar & 


Indications - 1) The BGV job is canceled due to an I/O error (Command 
Reject) on X'131'. 2) The error occurred during execution of a "SET 
FILE MASK* command (1F). 


Directions to _the_ Student - Type in // EXEC BUG10 on the console. 
When requested, re-IPL PL the default superyisor and enter the following 
commands: 
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‘A_PROBLEM 61 


| 7 - System 'CHANNEL PROGRAM CHECKS! because of invalid CCW 
command ‘code during execution of BGV I/0 operation. 


aos 


Directions to the Studeat - 
When requested, re-IPL the default supervisor 
commands: 


Type in L/ EXEC BUG11 on the console. 
and enter the following 


// JOB YOURNAME 
ASSGN SYS004,xX'131' 
// EXEC VSSCPRO3 


BG 4/7 JOB TAOSL 
NATE 04/27/77 
BG exec budii 
BG SYSTEM IS BUGGED 
TEL TO CONTINUE 


PAyCLOCN L4/733/24 


OTOSA SFECTFY SUPFERVISQR NANE 
OTO4] 
OTS0T 
OLLOA 
sat 

cle cl 

OTS 21 


TRL Ve x? Lao? ey VOLE R= 
DATEO4/27 7/7 49 CLOCKS 1 
GIVE TRL CONTROL 


LLL CPU TEE OOO TOOTS OL4aS 
La‘ 34/45 ZONES EAST/OO/O0 
COMMANTIS 


PAGE EXTENT LOW 


188 0 


VATA SET HIGH 

| 194 19 
OLZ0T DOS/VS TRL. 
BOG LIOQOA 


COMPLE TE 
READY FOR COMMUNTCATIONS. 
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OOOO0G04AG 
DOGOGOO9 


HOOGOO0O 
OF OF 2000 


90000000 
OOO0OBAC 


Indications - System "CHANNEL PROGRAM CHECKS! during execution of 
BGV I/O operation. 


Directions to the Student - Type in // EXEC BUG12 on the console. 
When requested, re-IPL the default supervisor and enter the following 
commands: | 


// JOB YOURNAME 
ASSGN SYS004,X*'131° 
// EXEC VSSCP03 
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T/A PROBLEM 63 


a + ions 
BGV 1/0 operation. 


~ System ‘CHANNEL PROGRAM CHECKS! during execution of 


Directions to the Student - Type in // EXEC BUG13 on the console. 
When requested, re-IPL the default supervisor and enter the following 


commands: 


// JOB YOURNAME 
ASSGN SYS004,X*131' 
// BXEC CCWTEST 

/& 
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soap 


cee tae ae 


ce Be 
Vs BiG GE 0 


WNT TNL 


VISOR NAME 


OpO4ayT TRLTEVe x’ TSO’ eUOLSE Re LPL pe feu te Goo LT O0LSaq 
rd Ad HATEMO4 (27/74 0 CLOCK@ 14/41/52» ZONESE AST /00/00 
OlLGS DPE TRL CONTROL COMMANTIS 

j 


« 
ewe sane 


VL CMR LE Te 
RE ATHY 


YOoOuUr Ame 
TOUR ARE 


ape, pes, 


wee ee, 


“ E ' (i F ft E Fe r PTL be Ee 
Ago an eS 


Ci bh ee ack 


aoe “eee Ci Sof sh oes SOR ery) 


er Lh ey eS 9 
aQilicha we oo : 
a a 


Seo “eee 


ican rr Milita fb Vel i: a YES se Dad 
1 oe et et 


Pew Oe 


J CTUELER BARE CANCE Tae Pup AAU Re 


Cry Sn CCS Ce YY Sc CS CCT 


eg pug ty poe ak pu tae pup a om 
ugk bab ged bi f AEE EEE eeg a }. 

% Pe tte Me oe ON OMe man) we Si i ee oN ~ s} z a Oe er ee ee ety af Ce de ee a) 3° Pa oe % Ce ee ee ee ee} f 
OOOO FS OOO0Re A OOOOOOSL GOOnnaARe OooOoooo4 


Fak a a a ae eae hoe ay a a he en 
ver Lb pe (é ii MePitee of Fh : 
mph sl ayeg hy hs AOOGUYE A OOO AR MARPSUSE LL RSL IA SS 


(ih 


MISTaTarererere 
WARFEP ESRI 


Pye ac ag add 


wt Fe OM te fe et oe t's Sh te Ot me et Oe Ot oh he te et “ett Me wv". t a %. % 7 
OOOO OOOoOOOO0 SISTOTOLOIOUSIS) OOOO 
OOOO Rio C1616 


a ee cree Le nc ce A a ee oy % 
ras. it C0003 rik 1.) Litas 3 ti i. { ; O *) és i { oe Oe it if ye 107018) 


355 


ae tee 
fiey 


OOOOP THO 


ace ae ie Se a ee a 
Pc eeyey Acicags 
re ee ee ea TT Te TT) 


OOGOO4AD 


O0000000 


Ore e1S1Src ara 
ARIE FL, 


STATS Tete Lente 


o% 2% Fe oh 2 ony oe a 
ii etad ‘ Po eh a if re 4 ry oT’ ae 2 éh é + 


HOO STOTOTOLOLOLOTS) 
OPO Soo 


1 


T/A PROBLEMS 101 THROUGH 105 - LIOCS UNIT RECORD MACROS 


ED SER ATES ALG TS LTD ETL IER 


Objectives 


Upon completion of these problems, the student, using the available 
documentation, should be able to: 


1. Locate errors in an assembled program that are caused by 
incorrect expansions of LIOCS UNIT RECORD Declarative and 
Imperative macros, and by source coding errors. 


Ze Use the correct logic manual (PLM) to identify correct 
imperative macro expansions. 


3s State the system procedures that are required to repair or 
update an incorrect macro definition in the source statement 
library (A. and E. macros). 


Directions to the Student 


These T/As utilize a program called SEQDISK as a vehicle to present 
macro expansion and source coding errors. A flowchart; assembly 
listing (which contains all the errors for these and subsequent T/As 
that utilize SEQDISK); and an example of correctly executed SEQDISK 
output (without errors) can be found in DOS/VS Base SCM 3. 


Each T/A has been executed separately (with only its own unique ‘bug! 
applied to SEQDISK) and the resulting storage dumps obtained; these 
can be found in DOS/VS Base SCM 2. The T/A listings in SCM 2 can be 
used to analyze these T/A problems if sufficient hard systems are not 
available to prevent an overcrowding situation during lab sessions. 


Storage dumps in SCM 2 do not contain supervisor code (except for those 
T/As where it is necessary or helpful); most LIOCS T/As require only a 
dump of BGV. | 

When progress is not being made on any of these T/As, refer to Student 
Guide topics LIOCS CONCEPTS and UNIT RECORD MACROS for possible trouble- 
shooting hints. If these hints do not help, contact your lab instructor. 


Contact your lab instructor after you have solved each T/A problen. 


Tools, Test Equipment and Documentation 


DOS/VS Base Student Guide 
DOS/VS Base SCM 2 
DOS/VS Base SCM 3 
/POS/VS Supervisor and I/0 Macros 


/POS/VS LIOCS Volume 1 
DOS/VS LIOCS Volume 2 
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© To apply the ‘bug! for any LIOCS T/A on a_hard svstem, the procedure 
LIOCBUGS must first be executed in order to load the BUGSYSTEM with 

the LIOCS ‘bugs' ( // EXEC PROC=LIOCBUGS ). A specific LIOCS T/A 

‘bug' can then be applied to the system as shown in the following 


table: 


HBUNC 


For T/A # EXECUTE 


EXEC BUGO1 
EXEC BUGO2 
EXEC BUGO3 
EXEC BUGON 
EXEC BUG10 
/ EXEC BUG1In 
EXEC BUG20 
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T/A PROBLEMS 106 THROUGH 108 -_LIOCS TAPE MACROS @ 


Objectives 


Upon completion of these problems, the student, using the available 
documentation, should be able to: 


1. Locate errors in an assembled program that are caused by 
incorrect expansions of LIOCS TAPE Declarative and Impera- 
tive macros, and by source coding errors. 


2. Use the correct logic manual (PLM) to identify correct 
imperative macro expansions. 


3. State the system procedures that are required to repair or 


update an incorrect macro definition in the source statement 
library (A. and E. macros). 


Directions to the Student 


These T/As utilize a program called SEQTAPE as a vehicle to present 
macro expansion and source coding errors. A flowchart; assembly 
listing (which contains all the errors for these T/As); and an example 
of correctly executed SEQTAPE output (without errors) can be found in 
DOS/VS Base SCM 3. 


Each T/A has been executed separately (with only it's own unique ‘'bug' © 
applied to SEQTAPE) and the resulting storage dumps obtained; these 

can be found in DOS/VS Base SCM 2. The T/A listings in SCM 2 can be 

used to analyze these T/A problems if sufficient hard systems are not 

available to prevent an overcrowding situation during lab sessions. 


torage dumps in SCM 2 do not contain supervisor code (except for those 
T/As where it is necessary or helpful); most LIOCS T/AS require only a 
dump of BGVY. | 
When progress is not being made on any of these T/As, refer to Student 
Guide topics LIOCS CONCEPTS and TAPE MACROS for possible troubleshoot- 
ing hints. If these hints do not help, contact your lab instructor. 


Contact your lab instructor after you have solved each T/A problen. 


Tools, Test Equipment _and Documentation 


DOS/VS Base Student Guide 

DOS/VS Base SCM 2 

DOS/VS Base SCM 3 

DOS/VS Supervisor and I/0 Macros 
DOS/VS LIOCS Volume 1 | 

DOS/VS LIOCS Volume 2 


T/A PROBLEM 109 THROUGH 115 - LIOCS SEQUENTIAL DISK MACROS 


Objectives 


Upon completion of these problems, the student, using the available 
documentation, should be able to: 


1. Locate errors in an assembled program that are caused by 
incorrect expansions of LIOCS SEQUENTIAL DISK Declarative and 
Imperative macros, and by source coding errors. 


2 Use the correct logic manual (PLM) to identify correct 
imperative macro expansions. 


3. State the system procedures that are required to repair or 
update an incorrect macro definition in the source statement 
library (A. and E. macros). 


TEED DG ORD EY ED ED SD AAS A TD 


These T/As return to the use of SEQDISK as a vehicle to present 
additional macro expansion and source coding errors. A flowchart; 
assembly listing (which contains all the errors for these T/As); 
and an example of correctly executed SEQDISK output (without errors) 
can be found in DOS/VS Base SCM 3. 


Each T/A has been executed separately (with only it's own unique 
"bug applied to SEQDISK) and the resulting storage dumps obtained; 

' these can be found in DOS/VS Base SCM 2. The T/A listings in SCM 2 
can be used to analyze these T/A problems if sufficient hard systems 
are not available to prevent overcrowding during lab sessions. 


Storage dumps in SCM 2 do not contain supervisor code (except for 
those T/As where it is necessary or helpful); most LIOCS T/As 
require only a dump of BGV. 


When progress is not being made on any of these T/As, refer to 
Student Guide topics LIOCS CONCEPTS and SEQUENTIAL DISK MACROS for 
possible troubleshooting hints. If these hints do not. help, contact 
your lab instructor. 


Contact your lab instructor after you have solved each T/A problen. 


TP TD A ATS A > AS aS a PP 


DOS/VS Base Student Guide 

DOS/VS Base SCM 2 

DOS/VS Base SCM 3 

DOS/VS Supervisor and I/O Macros 
DOS/VS LIOCS Volume 1 

DOS/VS LIOCS Volume 2 
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Objectives 


Upon completion of these problems, the student, using the available 
documentation, should be able to: 


1s Locate errors in an assembled program that are caused by 
incorrect expansions of LIOCS DIRECT ACCESS Declarative 
macros. 


2 State the system procedures that are required to repair or 
update an incorrect macro definition in the source statement 
library (A. and E. macros). 


Directions to the student 


These T/As utilize a program called DALOAD as a vehicle to present 
Macro expansion errors. A flowchart; assembly listing (which contains 
all the errors for these T/As); and an example of correctly executed 
DALOAD output (without errors) can be found in DOS/VS Base SCM 3. 


Each T/A has been executed separately (with only it's own unique 
"bug applied to DALOAD) and the resulting storage dumps obtained; 
these can be found in DOS/VS Base SCM 2. The T/A listings in SCM 2 
can be used to analyze these T/A problems if sufficient hard systems 
are not available to prevent an overcrowding situation during lab 
sessions. 


Storage dumps in SCM 2 do not contain supervisor code (except for those 
T/As where it is necessary or helpful); most LIOCS T/As require only a 
dump of BGV. 


When progress is not being made on any of these T/AS, refer to Student 
Guide topics LIOCS CONCEPTS and DIRECT ACCESS MACROS for possible 
troubleshooting hints. If these hints do not help, contact your 

lab instructor. | 


Contact your lab instructor after you have solved each T/A problen. 


Tools, Test Equipment and Documentation 


DOS/VS Base Student Guide 

DOS/VS Base SCM 2 

DOS/VS Base SCM 3 

DOS/VS Supervisor and T/0O Macros 
DOS/VS LIOCS Volume 1 

DOS/VS LIOCS Volume 3 
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Objectives 


Upon completion of these problems, the student, using the available 
documentation, should be able to: 


1. Locate errors in an assembled program that are caused by 
incorrect expansions of LIOCS INDEXED SEQUENTIAL Declarative 
macros. 


2. State the system procedures that are required to repair or 
update an incorrect macro definition in the source statement 
library (A. and E. macros). 


Directions to _ the Student 

These T/AsS utilize programs called ISLOAD and ISADRTR as vehicles 
to present ISAM macro expansion errors. Flowcharts; assembly 
listings (which contain the errors for these T/As); and examples 
of correctly executed outputs (without errors) can be found in 
DOS/VS Base SCM 3. 


Each T/A has been executed separately (with only it's own unique 
"bug! applied to either ISLOAD or ISADRTR) and the resulting. 
storage dumps obtained; these can be found in DOS/VS Base SCM 2. 
The T/A listings in SCM 2 can be used to analyze these T/A problems 
if sufficient hard systems are not available to prevent an 
overcrowding situation during lab sessions. 


Detailed instructions for executing each of these T/As (121 through 
125) are contained on the following page. 


Storage dumps in SCM 2 do not contain supervisor code (except for 
those T/AS where it is necessary or helpful); most LIOCS T/As 
require only a dump of BGV. 


When progress is not being made on any of these T/AsS, refer to 
Student Guide topics LIOCS CONCEPTS and INDEXED SEQUENTIAL MACROS 
for possible troubleshooting hints. If these hints do not help, 
contact your lab instructor. 


Contact your lab instructor after you have solved each T/A problen. 


Tools, Test Equipment and Documentation 


DOS/VS Base Student Guide 

DOS/VS Base SCM 2 

DOS/VS Base SCM 3 

DOS/VS Supervisor and I/O Macros 
DOS/VS LIOCS Volume 1 

DOS/VS LIOCS Volume 3 
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INSTRUCTIONS FOR SYSTEM EXECUTION OF T/AS 121 THROUGH 125 


T/A 121: 


T/A 122: 


T/A 123: 


T/A 124: 


T/A 125: 


ba sen eattae mentmnmneatl 


Type in // EXEC BUG21. Submit the ISLOAD job stream 
deck (see NOTE). 


Type // EXEC BUG22. Submit the ISLOAD job stream 
deck followed by the ISADRTR (ADD) job stream deck 
containing an UPSI 10 card. Then submit the ISADRTR 
(RANDOM RETRIEVE) job stream deck containing an 

UPSI 01 card. 


Type in // EXEC BUG23. Submit the ISLOAD job strean 
deck followed by the ISADRTR (ADD) job stream deck con- 
taining an UPSTI 10 card. 


Type in // EXEC BUG24. Submit the ISLOAD job stream 
deck followed by the ISADRTR (ADD) job stream deck 
containing an UPSI 10 card. Then submit the ISADRTR 
(RANDOM RETRIEVE) job stream deck containing an 

UPSI 01 card. 


Type in // EXEC BUG25. Submit the ISLOAD job strean 
deck followed by the ISADRTR (ADD) job stream deck con- 
taining an UPSI 10 card. 


NOTE: Obtain the required job stream decks from your lab instructor 
if you are executing these T/AsS on a hard system. 
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Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: | 


1. Use any of the following aids as a means to identify the 
location and/or contents of specified tables, constants, 
registers, instructions, and phases in storage prints (dumps) 
of IPL and Job Control. 


® Microfiche 
6 IPL and Job Control Logic (PLM) 
® Core Image Library Directory DSERV 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 


DOS/SVS IPL and Job Control Logic 

Dos/VS Serviceability Aids and Debugging Procedures 
DOS/VS Base SCM2 | 

IPL Release 29.0 Microfiche (SYC7-1946) 


JOB CONTFOL Release 29.0 Microfiche (SYC7-1948) 


Directions to the Student 


| MELE SAO ARIE: ALD CTS AG OSES SRT TED 


To complete this project you must answer study questions relative 
to separate storage prints (dumps) that were taken during the 
execution of IPL and Job Control respectively. 


The listings that you will require to answer the study questions 
for this project are contained in the DOS/VS Base SCM2 and are 
as follows: : 


IPL Dump (15° parts) 

Job Control Dump (6 parts) 

Partial DSERV of the Core Image Library Directory that 
contains the directory entries for IPL and Job Control 
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PART 1 — IPL 


BED 


Reference the IPL Microfiche (SYC7-1946) to answer the following 


mandatory questions: WW 5S Ob 10S3 vn 


Ts What is the.statement number in the $$ASIPL1 microfiche at 
which the disk address of $$A$SIPL2 is located? 
Statement +b * 


ED GE CEEED ES SEARS EP LS OP ED 


26 What label (name) is attached to the S$SA$IPL2 disk address in 
the $$A$IPL1 microfiche? ___ ADR 


aed 


ae At what statement in the $IPLRT2 microfiche are the version 

| and modification level bytes located? | 
Statement #_ ss ° 

4. What does the '@DL28' information contained in $IPLRT2 
statement 21 mean? 


@ 


22 CEE ED AED SUES ED CR GUE GREED GRE Gail? GEES GUE? CEP CUED ERED GaP GED WE EE GRE Se SEP ae aE OE EES TED AEP ap acs cad a a aE ED GE) ee aw a a EE GP ED ED OP GD EP ED GEE ane 


D 


GD IE a CEE CEES OL ED GED EASED a wali ten: ask CS ARMED o> CED CEE TE EL ERP Ca ee ED AE EE ED a ee a Ep PD Ga ED CE a GE OD A ED 
ED ED EAE SETS TIMED CLP ELL CALS LEG EGE IDG EID TS EN ES AS TAD SD AEP SP ATES EAD SENS NES TACKS RES ETD CERT ED STD EE CD STED TREY AE ES LEIA SLED ELE TIO IS 


28 


ARON SRP ALI GONE RL PREY ALLEY NOLS STS TY OE ET: SE SR LEE | 


NOTE: Refer to comment statements above statement 21 tc find 
answers for the above. 


Refer to the IPL Dump in DOS/VS Base SCM2 to answer the following 
mandatory questions: 


NOTE 1: The various parts of the dump were excerpted from a 
complete stand-alone dump of the system. All pages 
of the entire SA dump are not included. Only those 
pages that you will require to answer the study questions 
have been provided in the SCM (Refer to Appendix G in 
SADP for example of a STAND-ALONE dump output if you are 
not already familiar with this type of dump). 


NOTE 2: The SA dump was taken by the operator because the systen 
was looping during IPL. The operator stopped the systen 
and performed a STORE STATUS (ST) via the console keyboard 
prior to taking the dump. 


‘ 


ae In the dump, what is the address of the next instruction that 
would have been executed in the loop if the operator had not 

/, stopped the system and taken the dump? X* ; 
(Note: Refer to Store Status under ‘SYSTEM CONTROL® in the 


. Principles of Operation Manual 


6. In which IPL phase (in the dump) is the instruction that 
would have been executed next located? 


PED PLD LCS LELD I ID 
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ce 2 7 @ 
ger Hire rip. 


7. At what statement number in the IPL microfiche is the 
Noe instruction that would have been executed next located? 
Statement # 


AS CRED ED REED ES CSE COTA FED RY GAC AE A CRIN ER COTE AED TY CMS ane we ET ACES 


8. How many instructions are in the se) Oo was executing 
before the dump was taken? i Te er 


What are their mnemonics?  _— (22 “ERE SPULN 
1 —_ ee oY ; = . 4 1 j ‘ Ame « # y 
9. Why was the system looping ? Lorna tn CMe tbe BOP TOR 
Wh? i tay Ve, | : 


an eo ee ee oe AD A RS ATL A ESL NI NS EE SETS ATE SY ED A TAY EY alee AORN SND RAED WERE IED SNe 


Ti ch inded. 44. klew. etna na sath gna, } 


10. In the IPL and JOB CONTROL PLM, locate and identify the 
detail chart, and specific block on the chart, that represents 
the instructions that were looping. 


; x r ” ‘yg f ft A : EL 
Sleek oti fa PIPL Brae 
Lowel Nt! roy a Reg ar” ok a core ; 


i 


phen ee pink. F4 


*- 


Optional Study Questions 


If you encounter difficulty when analyzing the T/As associated 
with this work project, you may wish to enhance your diagnostic 
ability by answering the following optional questions: 


11. At what address in the dump_is the root phase of IPL loaded? 


Meee CIA Oe cere 


12. What other (if any) phases of IPL, in addition to the root 

phases and ae ayy , were in storage at the time the dump was 
During execution of $$A$IPL2, the I/O tables in the supervisor 
nucleus were copied into the area of storage immediately following 
the supervisor. Blocks 031 and 032 in the dump contain these 


copied tables. ZAG 


NOTE: Blocks 000 to 030 would have shown all of the 62K supervisor 
code if they had been included. Each block in the dump 
contains X'800' bytes (2K). 


13. The copied PUB table in the dump starts at address X'F88B'. 
What device address does entry '01' of this table contain? 
Xx? KE 


14. What is the address of the next available (unused) PUB table 


entry? X '--Ff p 


15. The PUB table entry for the I/O device with address X'0350'° 
is for what specific type of I/O unit? _ 


LTD KELLY NOIRE LAO ILD EID LETS EAS OS SAL AEP AR NTO TI IE 


S38 
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16. 


17. 


18. 


19. 


20. 


2 1.. 


2 2 


23. 


24. 


2. 


26. 


The copied LUB table in the dump starts at address xX'10090°. 
What is the PUB pointer contained in the SYSLOG LUB table 
entry? X' . Ss 


ED a EE ene OE One 


What is the address of the last LUB table entry in the system? 


eX 
In the formatted portion of the dump (starts on Part 15) what 


table in the Supervisor (not contained in dump) is pug aweress 
in Control Register 1 (CR1) pointing to? _{gwetFPy, 


Which partitions are indicated as not being active in the 
formatted portion of the dump? 


SSSR CNA EI AES EES ED aI EID RIED cS EIN AMER CI SL LS OS AS 


ES ES AES EE AE I Ac A AEE ELE OED OE AGS AED NP AD A OS CEES APT ED SY LP AY CIN AS EE RAD AEP EE ES CE REPAY CARD SA CSD GES ORE CIRENCESTER LED ET 


At what displacement in the Communications Region (shown in 
the formatted portion of the dump on Part 12) can the 
address of the LUB table in the Supervisor be found? 
Displacement X'_ ¢ ce mse 

In the formatted portion of the dump for the LUB table 

(Part 13), what entry in the PUB table (in the Supervisor 
nucleus which is not shown in the Sun) is the LUB entry for 
SYSUSE pointing at? Entry X*_ se 
What is the device address that is contained in bytes 0 and 1 
of PUB entry that is being pointed by the St Suse LUB pointer? 
Device address in PUB entry is xX'_ OOF 
How many PUB table entries are shown in the formatted portion 
of the dump for the PUB table? 


shown. Mo! : xO At 


What system logical units,do the entries as shown in formatted 
PUB table represent?  ™MAVeR GYUsGsS 


Using the formatted BOUNDARY BOX information in the dump, 
identify the origin address (in hex) of the first virtual 
address space address in our DOS/VS system. R* ... ' 


20 ewer <a ee ee ee 
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is Ba! 


12. 


= 1 6 * 


ng epnite iE GEA NET shag ys ASSET ES 
me fetid 
2 


Statement 61 (located on Card 1 - Frame A4Y of IPL microfiche) 
SKADR1 (label at statement 61) 


Statement 35 (located on Card 3 - Frame AW of IPL microfiche) 


rant denotes that the change activity has occurred on the 


A Se 


statement (has been either altered or added as the result 
of an APAR, PTM, or new development) 


LAE BOSE NAIA 


a 


ils the system identifier for DOS/VS. 


E 
é 
& 
i 
i 
5 


oO 


iy 
a 


'indicates the change was made because of new development. 


—. 


“3 
4 


| 
fs! indicates that the change was made for Release 28 of DOS/VS. 
X*T1E14" (Current PSW at time of dump was stored at x'000100' 
because of STORE STATUS operation. IA of PSW points to next 
instruction that would have been executed) 

$IPLRT4Y (Phasename located at X'11D60" in dump) 

Statement 4325 (The instruction is at a displacement of X'B4! 
from the beginning of $IPLRT4Y in the dump. In the microfiche, 
$IPLRTY begins at X*'1D40', plus X'B4* equals X*1DF4", which 

is statement 4325) 

2:SCK (Set Clock); BC (Branch Condition) 

The operatoc had failed to press the TOD-Clock Switch on the 

CPU console to the enable set position after entering an IPL 

SET command that contained the DATE and CLOCK operand. 

CHART EA; BLOCK F4 

X'10800' ($IPLRT2 can be found on PART 4) 

$IPLRT3 (can be found on Part 6 at X'11468') 

X*'OOOE® (Entry '00' contains X'O0O0C‘) 


X'F8FB' (The "'FF' null character in byte 0 of this entry 
indicates that it is unused) 


3330 Disk Drive (Indicated by X63" in byte 4 of entry). 


X¥'*05* (Points to the 6th PUB table entry which is for device 
X'OOTF', the console keyboard) 


x¥*10190' 
SEGMENT Table (CR1 is the Segment Table Origin Register 


(STOR) and bytes 1, 2, and 3 always point to the first entry 
in the Segment Table ina DOS/VS System) 
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19. 
20. 


21. 


22. 


23. 


X*OODEOO' 
F4; F3; F2; F1 (Refer to Part 11) 


X*4Ct (The Communication Region that is printed out on Part 12 
is thecommunication region for the BG partition (the partition 
that was active at the time the dump was taken). Each 
partition has its own communication region. There is also a 
SYSTEM Communication Region. The purpose and function of 
communications regions will be discussed and explained in more 
detail as the course progresses). 


Entry X00" (Byte 0 of SYSUSE LUB entry contains the pointer 
to the PUB entry for the device assigned to SYSUSE). 


X‘OO1IF' (This is the device address of SYSLOG - the device 
that was selected by the operator) as the IPL communication 
device) 

Two (2) (Entries x'00' and x'01") 

SYSUSE; SYSRES; (IPL Communication device and SYSRES device). 


X7080000' (Refer to ‘Origin of Virtual Storage" in B-BOX 
printout). 
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SS A TT ES A A TS A a eT 


Refer to the JCL Dump in the DOS/VS Base SCM2 and answer the 
following mandatory questions: 


1. In which partition was Job Control executing at the time the 
dump was taken? __ & oe 

2e Starting at what hex address are the contents of GR12 stored 
in the partition save area? x'_S0O0dC st 


3. What is the mnemonic of the next instruction that, would have 
been executed if the dump had not been taken? - 


W. Which phase of Job Con rol Piober eG addition to the root phase) is 
in the partition? _ 


5. What are the starting and ending storage addresses of the 
I/O buffer area? 
es i fh 
Y=160) 
Starts at DE y Ends at Xx? 60). 


6. What is the hex address in the dump of the last phase 
vector xt s6Ehy that was referenced before the dump was 
taken? X!_ 


Jo At what hex address in the dump is the last byte of SJOBCTLA 
located? X' S7&7¢ = * In the microfiche? X*_ 


Explain why these addresses are different. 


ED SE, RD EE SEED TE ED SE NN: ED AE ES NS ES ED ED TD ED OS ED EOD SD A ES SED AD AY OS A AS A A A A a A A A NS A RS ED AAD OARS SONY AND 


If you encounter difficulty when analyzing the T/AsS associated nw 
with this work project, you may wish to enhance your diagnostic mye 
ability by answering the following OPTIONAL. “questions: 4 


8. At what hex address was $JOBCTLA loaded? X*_ 


9. What is the length of the area (field) that immediately 
follows the I/O buffer area? bytes 


What label in the microfiche identifies this area? __ __ 
10. What message was issued aS a result of processing the state- 
ment contained in the I/0 buffer in the storage print? 


ASBZD Witt cw ret 


11. Which field of the statement contained in the I/O buffer 
caused the message to be issued? Field 
Why? __ 


12. 


13. 


14. 


The message contained in the message area was printed on both 


SYSLOG and SYSLST. At what label in the uicroprodram is the 
instruction located that moved the message into the message 


area? Label 


AES CED CED CEE EMS GP ES TSE CE EE SEED GUE a GORA GD GEER ETE ene nese a ERED EP RED 


On which Job Control detail chart can this label be found? 
Chart 


ap eee eee aE a ee ene 


At what hex address was the processing phase contained in 
the root phase overlay area entered? X'_ x" 


What are the hex contents of the version and note en Fon 
level bytes for SJOBCTLA in the dump? X*__ 
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ANSWERS TO WORK PROJECT 0 (JOB CONTROL) 


ES LL RED EELS LEAD ANTS ETE TET ETD [EMEP cmon ORD CED ea 


1. 


8. 


BGV (The PSW printed on the dump identifies the partition) 
x*8001C! 

TM (Test Under Mask - X*91" at X'8032". BGVPSW IA 
(instruction address) points to next instruction that would 


have been executed) 


$JOBCTLG (The last character in the first 8 bytes of $JOBCTLA 
is replaced with the character that represents the job control 


phase that has been called into the overlay area of $JOBCTLA) 


Starts at X'800F6'; Ends at X'8016D" (Refer to the label 
"BUFFER! in the $JOBCTLA microfiche) 


X'807B5* (The label of the phase vector table in $JOBCTLA 
in the microfiche is TBLADR) 


X¥*81887'; X'1888' (At statement number 3640 in the $JOBCTLA 
microfiche, $JOBCTLG has overlaid the initialization code 
contained in the $JOBCTLA. At statement 4071 in the 
microfiche can be found the "END' statement for JOBCTLA) 


X¥' 80078" (SJOBCTLA loads at the address immediately following 
the partition savearea) 


9. 80 bytes; LOGOVR 


10. 


11. 


12. 


14. 


Ix'81890° (Start of $JOBCTLG plus 8 bytes - refer to the 
' "Branch Displacement byte in the phase vector table 
(entry for a *JOB' statement (byte 8 in the entry)... 


1S03D INVALID STATEMENT 


Field 3; The jobname operand in the JCL statement was too 
long (more than 8 characters) 


CHAIN; CHART GJ 


i 


syn 


X'2900' (Indicates Release 29 version of $JOBCTLA). 
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WORK PROJECT 1 _- SUPERVISOR INTRODUCTION 


eS GEE STEEP ES SPE ED a a STG 


Objective 


Upon completion of this project the student, using the available 
documentation should be able to: 


1. Locate in a core dump the baSic communication control 
blocks of the Supervisor. 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 


DOS/VS Supervisor Logic 
DOS/VS Base Supervisor Listing 
DOS/VS Base SCM2 


Directions to the Student 
Using the core dump WP1N2 in DOS/VS Base SCM2 and the supervisor 
listing, answer the following mandatory questions: 


passed at the time of an I/O interrupt? X'__ 


Le What is the address of the routine to which contpol is A 
Ae ‘ 4 


2s What is the add e7s of the device that caused the last I/0 
interrupt? x' 4440 


3. What is the channel and device status of the device that 
caused the last I/O interrupt? oe BVIL 7 es 
YW. At what address was the current .PSW saved the last time 


the system was interrupted? x' Pamow Ye i: 0 


ai What is the beginning address of the system control program 
communication region (SYSCOM control block)? Xx'* ' 
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11. 


12. 


13. 


14, 


15. 


138. 


What are the addresses of the following: 


ae Logical Transient Area (LTA) X*_ 6319 ‘ 7 ahi 2G x 
b. Segment Table (STAB) X* | aa ' 
c. Page Table (pT) x' DFE 42 S78 


d. Boundary Box (BBOX) X' _ DRex t Som ' 06! 


e. DPD Table (DPDTAB) X' 
fs Background Communication Region (BGCOM) Xx'* ARD ms JY 


What are the beginning addresses, in decimal, of the 
following areas? , Bove 


FIR Partition “Giiro 


AED AA EE I IDS aD eR ENERS SACD AS TED AAA TP EATEN CANE OOD ATR 


a. MRE LOO 


f AP SP ED A A ED OP ES ED RAD a OTP CREE RIE END RN 


What are the end addresses, in hex, of the following virtual 


partitions? 
a. soe xt 20d#4 404300 - 


Te Crs: ee Le 
Ge ‘ Lee ‘ ds 
. pee ae 422300 


eC. F1 x’ ¢3 


} 
How many page frames are there in the main page pool? Ag 


How ma bytes are allocated the smallest real partition? 


F4. Ao UP — 18000 


Are, there any partitions with an 
If so, which ones? __ _Fay 


me ee ED eRe LE AS AES CS A A AE TT AT AS A TS SU ALD SN A A TNS 


llocation of zero bytes? 


What is the address of the Sheek on which the page data set 


resides? xt 424 tt Suc D'—» OODIAB . fyas p42. 


State the number of records that can be contained on each 
track of the page data set (SYSVIS). 


amp «pe emp oO EP Se QE A a ar a ee ey ED aD 


At what 2 and head can, t first track of SYSVIS be 


found? cyi_()____wEAD_OO 4 29% Pye CYL pA, Hu J 
At what cylinder ,and head can the last track of SYSVIS 
be found? CYL_4¥ tgs Jaatees ba CYLG MA IG, 


What is the lowest hex address in the DOS/VS Base System 
that can ever have its contents paged-out to SYSVIS? x1 0. 
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S ANSWERS TO WORK PROJECT 1 
Vs X*A74" (Label:ENTIO) pointed to by the I/O new PSW. 
2% X¥*131' (I/70 device address stored at address X'B9*) 
Se Device end only (CSW stored at address X*40*) 


4. X'38' (The address of the last saved PSW is stored at 
label HLDPSW) 


De X*540" (Address X*80' contains the pointer to SYSCOM) 


6. ae LTA — X*'6810° 
b. Segment Table — X'*DEOO! 
Cs Page Table - X'D7E8'* 
d. Boundary Box - X*4DBOF 
Ce DPD Table —- X*4E10° 
ft. BGCOM — X'4AO! 


7. ae BGR - 63488 
b. F4R - 83968 
Ce FIR - 118784 
d. MPP ~- 192512 


8. ae BG -— X'1017FF'* 
be FO —- X'1T177FF! 
Ce 3. = X*1287rr* 


d. F2 - X'13B7FF'* 

¢ e. F1 - X'13B7FF* 
9. 162 (Halfword, BBOX+6) 
10. 2088 (Halfword, BBOX+4) 


11. Yes (F1V) - Starting and Ending addresses are equal (No 
allocation) 


12. X'131" (DPDTAB + 0) 


13. 3 - The halfword at DPDTAB +2 is used by the Supervisor as a 


NCL | displacement into the table labeled 'DCL' for it to determine 
< this answer. The 'device-constants-list' contains the number 
Lo, SYBV8 of records per track and the number of tracks per cylinder for 

Hest all of the possible SYSVIS device types. 


14. CYL —- 0001, HH - 0000 (DPDTAB #4 is the 'Relative Track Low' 
which is the track relative to CYLO-HDO on the disk for the 
beginning of the extent for SYSVIS) 


15.2 CYL = 0009, HEAD = 0019 (DPDTAB +8 is the *Relative Track High"). 


16. xX*'80000" (This address is the beginning address of virtual 
address space in the DOS/VS Base lab systen.) 


WORK PROJECT 2 - TASK SELECTION | @ 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Locate in a core dump the control blocks used for task 
selection. 


AE PATS EEE ES GE ED EEE ES Gc OE EO A a 


DOS/SVS Supervisor Logic 
DOS/VS Base Supervisor Logic 


DOS/VS Base SCM2 


Directions to the Student 


Using the core dump WP1N2 in DOS/VS Base SCM2, and the Supervisor 
Listing, answer the following mandatory questions: 


a 
1." What is the address of the Partition Identifier Key (PIK)? & 


a x! __ ACE ’ AOMUKEG, ' 93' 
2 What is the address of the PIB Table? oo My VE be {ime afer . 


VV 
a What is the address of the Background System Savearea? 


rt AEB 


4. What is the address of the BG Partition Savearea? x1 LEM t 


5.“ For SVC, I0, and all PC interrupts (except page translatjo | ; 
rQLT a exceptions) the interrupt code is stored in the Sith Real MAAK S | : 
SWC DEB, WOBA, KO 
6. x Sede the address of the first System Task Control Block. 
xt 


Ts What General Register would be stored at a displacement of 
X¥'10" into any Problem Program Savearea? GR 


8. If the byte at RETAB + X'85* was 00, what system resource 
Gee es” in use? __ ee yes bud ik ba 4 fit 7A be. Noaetd . 


TRTMACK — X'S! =a stmT 44469. 
TCM 
© 
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@® 9. Given the following System Tasks, list them in priority 
sequence. | 


OD REE EE AS EES AS ED CPD eS 


10. Are the System Task Control Blocks physically located in 
priority sequence? M - 


11. Which task selection control block determines the system 
task priority? 


Mi See oo she rine eae, png mtnnier tee HEE 


13. When SVC33 is issued by a eUECE VASE task, what is the 


SELECT byte set to? X*_ = 
Y met). 
hb 08 #4 95 


If you encounter difficulty when analyzing the T/As associated 
with this work project, you may wish to enhance your diagnostic 


® ability by answering the following OPTIONAL questions: f 
14, What is the current value of the PIK? x: EPPS . BG 
he 15. SPIK is used to identify the task in control of the system or 


ithe task that was last being serviced by the supervisor. 
ijInternally the PIK value is, ysed as a displacement into what 
table (control block) ? litte 


__t TAG. 


Ep OP aE a IN 


17, Are there any partitions waiting for the services of the 
page manager to complete? __ 


18. At the time the dump was taken, which partition, if any, BS 
had control of the LTA? : 


SR TES EP ORES SERS ED OE a 


TD AE SAS aE ED 


EE CD 


19. Considering the answer to question no. 18, what was the 
service requested by the BG partition? 


ED ATS ED GS GETS RNS EY MIE SOAS EE Oe ERT GR GD PED eee Se 


20. What is the address of the System Task Savearea of the 
last systen veer that was in control of the system? 


ES Oe Ee ES ED ED EE EE a 


21. What is the address of the system savearea of the paren 
being serviced by the last system task? xX! 


fa? oo SVCE banal 
@ ke i ee 


“Ta 


22. Was a system task in control at the time of the dump? e 


7. seeeeeeene: Vp 
at 
23. [ the byte at address X'2A5A* was changed toa X¥'83" and (Maik tik Wik 


Mareen ceamren PAE 


be placed in ASYSBLEX? ae ee Aalalt ¥) bintie 41 book boa 


What byte in the TRTMASK Field will be set to zero when 
an SVC22 is issued? Address X'* 5. _' 
When the byte referenced in the previous question has been 
set to zero, what PIB flag will be used to prevent the 
dispatching of any problem program other than the one that 
issued the SVC22? x'_~#3,  __! 
30/78 - 
| 26. What is the PIB FLAG for the supervisor task set to when 
it issues an SVC33? X*_ mae? tae cue 


eed A 
W022 ° Sarg. | rlearce, 
(9 duals | dasaAlh wefernad Aol Yo wt 


Oped boy mm AMibrk Der , 


TMG TKO Athos emcees Aol WIAs oVanrus, athlon mietes sMmed (5 scam f - 


TRIMS 


re 
ie f 


Y S) 
tp d of 
: 4H 


a * EN moe pein ser A OOP TN er ee hENes eS NEO BN TSE my OY OER at AP BH ei 
re a [. Ae i mA MNO Pin IM age Ls HERE | amy, 


vi “PID tg tek 6 43 
ip Letra . 


ANSWERS TO WOBK PROJECT 2 


10. 


11. 


12. 


13. 


14. 
15. 
1 6., 


17. 


18. 


X*4CE* (BGCOM + X'2E*" contains the PIK that is altered to 


indicate which partition is in control) 


K*2DFO* (BGCOM + X*5A*) 

X'GE9Q" (BGPIB + 9) 

X*80000" (ARPIB + 5 because this address and the address of 
LTASAVE are swapped in the PIBTAB when a partition gains 
control of the LTA) 

Program Information Block Extension 


X¥*2C14" —- S¥SCOM + X'98* (ASYSBLKO) 


Register 9 (Registers are stored 9 through 8 starting 16 
bytes into the savearea) 


The Physical Transient Area (PTA) Label - TRIPTA 


ae 4 
b. 6 
Cs 1 
d. 3 
e. 2 
f. 5 


No (The PAGEIN SYSTEM TASK is third in priority but its 
control block is physically located sixth) 


TIDFLD (Entries are by position highest to lowest priority). 
F3, Fu, F2, BG, F1 (SYSCOM + X'B4' contains address of 
MVCFLD which contains the dispatching priorities high to low 
for the partitions and the attention routine). 


0 - ZERO (The system task is relinquishing control, if needed, 
to a higher priority system task) 


X*0010* (Background) 
Program Information Block (PIBTAB) 


3 (F4, F3, and F1 have PIB FLAGS of '80' indicating program 
not active. The Attention Routine is also not active) 


No (None of the PIB DAT FLAGS are set on except Virtual 
Mode). 


Background (LTK at BGCOM + X'6E* contains PIK of LTA owner 


when it is active. When the LTA is inactive, the LTK 


contains zeros) 
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19. 


21. 


22. 


23. 
24. 
25a 


26. 


Boy teAworted . 


SVC67 - PFIX (Along with the savearea addresses being swapped 
when the LTA becomes active, the interrupt codes are swapped 
in the PIB2TAB) 


control block for the task that was in control. Bytes 5-7 0 
this control block contain the address of the savearea). / 
ye pal tok 


X'5818" (SYSCOM + X'9C' (ASYBLKX) points to the system task | gpl. daz 4- 
£ gre anes ()- LM 


X'4E90! (Byte 2 of the SUPVR SYSTEM TASK CONTROL BLOCK CAW 
contains the PIK of the partition being serviced, in this 

case BG; and the address of the system savearea is in 

bytes 9-11 of the PIBTAB entry) 


No (The SELECT byte (SYSCOM + X'44") is 00 indicating no 
system task in control of the system) 


X*2C24' (Address of the PMGR System Task Control Block). 
X'6EB" —- TRISIEZE (RETAB + X73") 
x* 73" 


X¥'83" (If no higher priority system task is ready to run, 
this task will regain control of the system) 
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Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. In a core dump of the system, locate and interpret the 
various control blocks used by the channel scheduler and 
I/O supervisor. 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 


DOS/VS Supervisor Logic 
DOS/VS Base Supervisor Listing 
DOS/VS Base SCM2 


Directions to the Student 


Using the Supervisor PLM, and referencing the WP03 DUMP in 
DOS/VS Base SCM2, answer the following mandatory questions: 


1. What is the address of the PIB table? x1 OO . 


os Using the value of PIK as a displacement into the PIB table, 
find the PIB entry associated with the problem program 
xt Wego active. What is the address of this PIB entry? 
Xt | 


3. Using the PIB table find the address of the problem program 
savearea for the active, partition. What is the address of 


that savearea? X*_ — —" AR 


We Find Register 1 oh the savearea. What is the value in 


Register 1? X!_ Pb 


5s Register 1 points to a CCB in the progran. 
ae What is the Symbolic Logical Unit in the CCB? sys 00S _ 


b. What is the CCW address? Xx! 4K : 
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6. 


10. 


11. 


Using the value in bytes 6 and 7 of the CCB, go the LUB table ) 
and find the assignment for that Logical Unit. SYSOS © 


Ae What is that assignment? X'* Lwuircoth » PP 


Find the LUB entry for SYSOO4. 


De What is the assignment for SYSO04? Xx! oe ¢ 


Ce Is there a JIB pointer? NO. 


Using SYSVIS'ts JIB pointer, find that JIB entry. 


ae Does SYSVIS have an alternate assignment? NO 


Ds Why is bit 4 in byte 02 of SYSVIS‘'s JIB entry ON? EKIGTT LADICHEM 


----—— 0 


Find the SYSREC LUB entry: 


b. What device is it assigned to? x'_¢ 


Cz What are the JIB (Ss) being used for? — KT, 


2/234) 2319 LCTENTS 


ES ED TRY ED OEE ED GOED CED CEP CRESS aD cE aD eDOE ermurs RD Oe cere ED AED ce ee =n aD cna oD 


_———— By Secheteems Stas 
d. What are the extents? Cs CS MEAS 


Look at the PUB entry for SYSRFC: © 


ae What is the device address xX' WV! 


- , ZF 
b. What is the device type? X*_#"" 7 ’ 


AR SE fie ae ane ae 


According to the FREE LIST POINTER: 


a. Which CHANNEL Queue entry is the first one in the free 
list? 


RED CEE CE ED RE EE ENE. SATE ORE ED eter > ED ae OD <TD 


f 
b. How many entries are in the free list? 0 


Ce What is the Br address in the second Channel Queue 
entry? x'_ & D oy 


d. Why is there a CCB address in the second Channel Queue 
entry when that entry is in the Free List? } te 


According to the channel control table, what type of channel 
is channel 1? 


Glee fox Channel 
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12. 


According to 


Ae What is 
started 


b. What is 


Cz What is 
x? 


the CHANNEL BUCKETS: 


the channel and unit address of the last device 


on Channel 0? X' 


~ | 


Re PUB address of the first PUB on that channel? 
q 


8. 


11. 
12. 


X*2DF0! 

X*2E00! 

X*F800! 

X*F8A6! 

a. SYSO05 - Bytes 6 and 7 in the CCB contain x'0105! 
Programmer Class (01) Sixth Unit (05) 

b. X'F8B8" (Points to first CCW, but there may be more than 
one). 

ae Unassigned (X'FF* in LUB) 

be x*000C* 

Ce No 

ae No 

b. Because bit 2 of byte 02 is also ON. 

a X*'0801' 

b. x*131° 

Ce 2311/2314/2319 extents 

d. Extent is: Lower Limit 197; Upper Limit 197 (Only 
one extent because byte 03 is "FF’ - not chained) 

ae X¥*131' 

b. 2314/2319 

ae 01 or the SECOND entry 

De 16 

Ce X"6BBO! 

d. It is residual (left over from a previous I/0 request). 


Selector Channel 


ae 
be 
Ce 


X"QOE® 
X¥'30A6! 
x*3096! 
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WORK PROJECT 4 - ERROR RECOVERY 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. In a core dump of a DOS/VS System, locate and interpret the 
various control hlocks and areas used by the Physical Device 
Error Recovery Procedures. 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment, and Documentation 


DOS/VS Error Recovery and Recording Transients Logic 
DOS/VS Base Supervisor Listing 
DOS/VS Base SCM2 


TP ND wien ingen NP RR TP AS A SD ED aD ai 


Using the Supervisor Listing, WP0O4 Core and Disk Dumps in DOS/VS 
Base SCM2, and Error Recovery and Recording Transients PLM, answer 
the following mandatory questions: 


1. Refer to the System Communications Region (SYSCOM): 


ae What is the address of the current system task 
block? xX!_ 


be. What value does the System Task Identification Field 
(STID) contain? X' * "4S __ EV 


Ce Which system task is currently active? 


2. Going to that System Task Block: 


Ae What is the address of the savearea for that system 
task? X'_ 5D 

be Which User go. is being serviced by this system 
task? xX! ‘ 


CT, TP TO AD NGO 
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Since this is the Error Recovery Task: 


ae 


be 


Xx? 


What is the address of the error block? X*__ ‘ 


WO the address of the Physical Transient Area (PTA)? 
t 


Going to the Error Block, we find that an error has occurred. 
Look at the first error queue entry in the Error Block: 


Ae 


What is the address of the CCB? X!? PRG ¢ 


What type error is indicated? 6 VC, (1 mex ule =a IC Pare 


AO A ETD EE OD AS INES SED CES I AS OE EP NG EC ED OE EE SED aE 


{ Using the formula in the PLM for finding the PUB2 entry fa 
a device, find the PUB2 entry for device X*Q00C*. 
What is the address of this PUB2 entry? X*__ nee 
What is the SYSREC cylinder/head address? X's 


b. 


(HINT: Kept in the recorder file table) 


Looking at the DASD Disk Dump of SYSREC, specifically 
Record 2: 


tat 


What type of record is this record? 


EGY eA CR ete a eR EE A A a 


What type of device is this record associated with? 


OE A A OOTY EY AEP ED ENE ETD A ED GE OD SE Ap re EE Eee cnet eee oa oD ny EP OR ED ee er OED oie Gate este CSR Ge as EP EE A ae Re aS A ED SED EN ED aD 


What is the device address? x! ‘ 


ES A ETD GET OEE aE CE eT cole 


transients are used for Physical Device Error Recovery. 


Look at the Physical Transients Area (PTA): 


de 


b. 


RNS ES ED ES CY ED TTS CD 


“ 
What is the function of this transient? kl Masageul& 


ED ENED ONT A SD EY A OS A AS ET OS NS TOD AS ES AS AS AE OO A OS ARS A NS A SO AS NY ED ED TS NP AO SY SY ND TY A AS ID RD nein <RNE OND 
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ANSWERS TO WORK PROJECT 4 


Ae ae X*2C3C* 
b. x*0005! 
Ce Error Recovery (ERP) 


2e ae X*57D0°* 
b. Background (PIK=10) 


35 ae X*4CAC'? 
b. X*70D8* (SYSCOM +#+xX'*'94) 


4. Ae Xx*000C* 
b. X'FSA6! 
Ce Equipment Check 


56 ae X'*5F98' 
be. 00C50000 or Cylinder 197 - Head 0 


6. Ae Type 1 I/0 Device Record 
b. 2540 Card Reader (Device Type Code 11; Bytes 52-53 in 
Figure 32) 
C. x*'*Q00c* 


Va Ae S$$ABERRN (First Eight Bytes of Transient Area) 
b. Message Writer (Figure 2 ERP PLM) 


387 


Objectives 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


: Locate the control blocks used to handle a machine or channel 
check on a Systemn/370. 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 


PEEP LD 


DOS/VS Supervisor Logic 

DOS/VS Error Recovery and Recording Transients Logic 
DOS/VS Base Supervisor Listing 

Dos/VS Base SCM2 


Using the WP05 Core Dump in DOS/VS Base SCM2, and any available 
documentation, answer the following mandatory questions: 


This standalone dump was taken following a data compare trap that 
referenced the ERPIBQ at the time of a Channel Interface Check 
(see Stored Status area). Normal operation would continue with 
the cancellation of the task with the msg. OP82TI JOB XXX 
CANCELED DUE TO CHANNEL FAILURE. 


1. Does a Channel Control Check or a Channel Interface Control 
Check cause the loading of the Machine Check New PSW? __ 

2 What type of Channel Check caused the Resident Channel Check 
Handler to gain control of the system? 


3. Was an Extended Channel Status Word (Limited Channel Logout) 
stored for this check? 


CD AS OD GED a ONE A GE ERED SD 


4. What is the fixed address of the LIMITED CHANNEL LOGOUT ECSW? 
Xt t 


ETRE AALS LD PE ES A EID 


ar Was it the CPU or the Channel that recognized the check? 


22E SD CED ep Gp ME? aa 


6. Was the source of the error from main storage or its 
- controls? 


EES EP EATS SED AED ATE RES ST TS AS 
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7. Was the channel and device address recognized as being 
valid? __ 


8. What is the address of the RAS Linkage Area? X' ' 


9. Is the RAS Monitor active in the dump? 


10. Was the Channel Check Handler entered from the SIO routine 
or the I/O Interrupt Handler? 


AD ED ET TALLY AISED AGE AS EAR AE EERO CEL 


11. What is the ecerers of the RAS Monitor Table? (RASTAB) 
x? 


PD LP TP STP 


12. At the time the dump was taken, which RAS transient was 
activated? 


13. What is the CIL disk address for $$RAST01? Cyl 
Hd Rec 


AL AIS EG PETAL LTED PEP caneapt cian -saemenente neebaee 


14. what. is the address of the RAS transient area? X*_ : 


EN ELIS ATL LETS LED 


15. What RAS Transient is currently residing in the RTA? 


SEL STELLD TEES TILA LLY LIL NLD SLI PRD LLLP LAD 


16. What is the address of the (EBETE) Error Recovery Procedure 
Information Broeke xy 


TD ED 


Refer to the WPO5 SYSREC Disk Dump in DOS/VS Base SCM2 to 
answer the remaining questions. 


17. What type of records are recorded on SYSREC at Cyl 197, Head 
Records 2, 3, and 4? 


RE RESEND CUP ES CREED GREP GPE HEED GMT OEP GEES SE CA DEE GD 


18. What was the CPU serial number contained in the records 
referenced in question 17? 


19. What was the job name being used at the time the records 
referenced in guestion 17 were recorded? 


20. How many devices were active at the time each check 
occurred? 


RES ARE CSREES AERC IED AAR AN ATE IO 


21. What command was issued to the tape drive which caused 
SYSREC record 2 to be written? 


DP ED A ES GD EP IP aD SS aE? OPE Ai aaah 
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nD GP ete a Op a ene anes eae: A AD AD ALS A 


If you encounter difficulty when analyzing the T/As associated 
with this work project, you may wish to enhance your diagnostic 
ability by answering the following OPTIONAL questions: 


22. 


2 36 


24. 


25. 


Because of the timing of the core dump, some significant 
data has not as yet been placed in the ERPIB. There is 
some data temporarily saved in a non-documented area just 
prior to the RASTAB that may be of use in troubleshooting 
any RAS problems. You may want to make note of these for 
future reference. Starting at RASTAB-24, there isa 4 
byte savearea for Reg.8 which is the BAL Reg to the routine 
to dequeue an I/O request (RASDEQ). It can be used to 
determine which routine called RASDEQ. RASTAB-20 is used 
to save the address of the PUB TABLE entry for the device 
in error, and RASTAB-12 is the address of the current 
ERPIB entry being worked on. RASTAB-16 is the CHANQ 
address. 


Using this information, what is the Channel and Device 
Address being accessed when the Channel Check occurred? 
X* __._* 

Had the CCH been allowed to continue, at what address 
would the PUB pointer have been placed in the current 
ERPIB? x's 

What RAS transient will eventually be called to handle a 
channel check for this device type? $$RAST _ ee 
Use the 'Channel Check ERP Decision Tables in the 

DOS/VS Error Recovery and Recording Transients Logic to 
answer the following question: 


Given the same ECSW as in the dump, but with a test I/0 


operation issued to a 3505 card reader having byte 2, bit 3 
off in the user's CCB, what action would be taken? 


Re RR ED RED EE ND CE A EE, AD ER EE EE EEE ED ED ED A ED CD ED CED ER AED TED END AD AS EE A AD EAD AS AALS LP ED IS TY A PD 
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ANSWERS TO WORK PROJECT 5 


1. 


10. 


11. 


12. 
13. 
14. 
15. 


16. 


17. 


No (These two checks are indicated by bits 45 and 46 of the 
Channel Status Word and are recognized by either the SIO 
routine or the [/0 Interrupt Handler which then passes 
control to the Channel Check Handler). 


Interface Control Check (Bit 46 is on in the CSW contained 
in ERPIBQ - CSW at X'40*" has been overlaid by SA dump). 


Yes (This was accomplished by the hardware at the time the 
CSW was stored - Bit 5 in CSW). 


X*BO' (Refer to FIXED STORAGE LOCATIONS on S/370 REFERENCE 
SUMMARY card). 


The Channel (Bit 5 of the Detect Field in the ECSW is (On, 
indicating the channel detected the error). 


No (Bits 9 and 12 of the ECSW being on, and not bits 10 and 11, 
might indicate to the hardware CE that the problem was coming 
back from the channel or control unit that was being 
accessed). 


Yes (Bits 16, 19, 21, 22, and 23 being on in the ECSW 
indicates that the addresses sent to the channel were valid. 
These bits being on will cause the CCH to continue to attempt 
to retry the I/O operation). 


X*640" (SYSCOM + X*70" contains a pointer to this control 
block). 


Yes (Bit 0 of the RAS Flag Byte in RASLINK being on 
indicates that the RAS Monitor has been activated). 


SIO routine (Indicated by bit 6 of the RAS Flag Byte being 
On). 


X*C798* (RASLINK + X'0C*). 


$$RASTOO (LDOOSLOT FLAG BYTE-BIT O (Activated Bit) is the only 
Activated Bit on). 


Cyl 3 Head 12 Rec 1 (LDO1SLOT bytes 1, 2, 3 contain cyl, hd, 
rec address of this transient). 


X'C930' (The address of the RTA is contained in the data 
address portion of the RASREAD CCW (RASTAB + X*'68'). 


$$RASTOO (The name of the Phase contained in the first 
eight bytes of the RTA) 


X'c8scc' (label ERPIBQ in Supervisor Listing). 


Channel Check Records (Indicated by X'20" in byte 0 of the 
records - Refer to SYSREC Record Format Charts in SY33-8552). 
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18. 
19. 


20. 


2 1., 


22. 


23. 


24. 


2 


10791 (Bytes 17 - 19 in the Channel Check Records). 


WPOS (Bytes 24-31 in the Channel Check Records). 


2 (Bytes 32-47 in the Channel Check Records indicate the 
addresses of the I/O units active at the time of recording. 
The active devices were O1F and 282. Refer to WPO05 EREP 
Printouts for formatted SYSREC records). 


Set Mode (C3) (Bytes 48-55 of the Channel Check Record 
contain the failing CCW). | 


X¥"'282" (RASTAB - 20 contains the pointer to the PUB entry 
for 282). 


X'C8DA' (14 bytes into the ERPIB pointed to by the address 
in RASTAB -12). 


$$RAST12 (PUB DEVTP indicates a 3420 tape drive (X'52'‘) 
which is handled by this transient). 


The program would be cancelled (Refer to ‘I/O Recovery 
Procedures and Sense Data! for the 3505 in SY33-8552). 
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WORK PROJECT 6 - INTERVAL TIMER AND EXIT MACROS 


bijectives 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Determine the operation of the interval timer and exit 
@acros. | 
2 Identify areas in the supervisor used by these macros. 


Time required to complete this project averages 1.0 hours. 


ne GD pepe eae 


DOS/VS Supervisor Logic 

DOS/VS Supervisor and I/O Macros 
Dos/VS Base Supervisor Listing 
DOS/VS Base SCM2 

DOS/VS Principles of Operation 


Directions to the Student 


ne 8b GD eee ee ee 


Using the above indicated documentation, become acquainted with 
timer and exit macros and their associated SVCs. 


Step 1 Read INTERVAL TIMER in DOS/VS Principle of Operation. 
Step 2 Read the descriptions of the following macro instructions 


in DOS/VS Supervisor and I/O macros. 
STXIT, GETIME, SETIME, TTIMER, TECB 


Step 3 Observe the SVCS generated by the macro instructions 
in the WPO6 Sample Program Assembly listing in DOS/VS 
Base SCH2. Read the function of these SVCs in the 
DOS/VS Supervisor Logic. 


Step 4 Option tables are generated by the FOPT macro at 
System Generation. They are located in the supervisor 
with the labels PCTAB, ITTAB, and OCTAB. Refer to the 
DOS/VS Supervisor Logic to find their formats. 
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ju 
é 
[ 


The output of the WP06 program contains several 

PDUMPs of storage locations containing information 

set up or used by the timer macros. Prior to execution 
of a PDUMP in the WP06 program, the information contained 
in Registers 0 and 1 is moved to other registers so that 
the PDUMP macro doesn't destroy it. 


Correlate the source listing, output and documentation; 
then answer the following mandatory study questions. 


Statement 5 in the source listing is a GETIME macro. During 
execution of the program, at what time of day in hours, 
minutes, and seconds was this macro issued? (Note instructions 
at statements 30 and 31, and the first PDUMP at statement 52). 


Hrs Min Sec 


<< et th eae eee ePeneee qu Ge eee ee ese ee a qenn queens en eae a eee 


The first PDUMP displays what table(s)? 
The third PDUMP displays the TECB. Does it indicate that the 
time specified by the SETIME macro has elapsed? __ 
The second PDUMP displays SYSTIMER and SYSTOD. Approximately 
how much time remains in SYSTIMER? 


What value is contained in the BG PC option table entry in 
the cancel dump? X' 


Does DOS/VS provide interval timer support for all 
partitions? 
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ANSWERS TO WORK PROJECT 6 


1.. 


6. 


Register 11 was loaded from register 1 and contains 
0190933C or 19 hours 09 minutes, and 33 seconds. 
Register 10 now contains the minutes in hex. (See 
statement 18). 


ITTAB 


No (Bit 0-Byte 2 is 0 at address X'802FC' -- SETIME has not 
elapsed). 


About 8 seconds - Bytes 50-52 contain 000969. Converted to 
decimal this equals 2409 (Then divide by 300 because the 
time is in 1/300 second intervals). 


All zeros starting at X'2E50' (The EOJ transients clear this 
area). 


Yes (Beginning with Release 28, DOS/VS provides multiple 
partition timer support. Before Release 28, only the 
partition that had the timer assigned could support the 
timer macros). 


re 
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WORK PROJECT 7 - FETCH/LOAD 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Locate and interpret the contents of control blocks used to > 
Fetch or Load a phase. 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 


DOS/VS Supervisor Logic 
DOS/VS Base SCM2 
DOS/VS Base Supervisor Listing 


EEE RD PEP A A ED RES CLE SIELP LEP RETEST ELD SED AR SLD LETS LS IP 


Using the WP07 Storage Print in DOS/VS Base SCM2, answer the 
following mandatory questions: 


es What is the address of the Fetch Table? x» 0278 ' 


Zs What is the address of the SYSRES Second Level Directory? 
6G 


Xx? 
36 At what cylinder and head does the Core Image Directory 
| always start for SYSRES? Cyl_ weet “HGS cs er 


4. What is the phase name in the last entry on track 2 of the 
SYRES Core Image Library? 


Se How many Core Image Library Directory tracks can the System 
Second Level Directory support? 


6. What is the name of the control block (work area) used by 
the Fetch routines when fetching or loading a phase? 


CREED ED GOED CRED CED ERLE CEEED GEDDY CELE CMD CED ED IPO POLED LTD SACRA ED ED CAE CH EP CRE OI ED ELD ND AS SRD CY EES NY SD CREED CIEE cD ES 


Te What is the address of the TCB for Background? X' seis teat a 
8. What was the SVC that was issued to cause the activation of 
Fetch? SVC 


EEG OEE Ha GED Gay CED eS CE 


ED AED ED RATED ED 
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9. What is the name of the phase being fetched or loaded? 


10. What is the address in the problem program area eer the 
phase name was originally found? xX*_ | 


11. How many RLD items are in the phase being fetched or loaded? 


Using the WPO7 Disk Dump of the Core Image Directory in DOS/VS 
Base SCM2, answer the following mandatory questions. 


12. How many tracks are allocated for the Core Image Directory? 


2 ED CEES CEPTS EE AE LS SE 


13. How many cylinders are allocated for the Core Image Directory? 


ESTED ID TNS TIED AD GELS? RES OEY AED ES GEL RED 


14, How many tracks are in use in the Core Image Library? 


RE RA TE A 


OPTIONAL Study Questions 


If you encounter difficulty analyzing the T/As associated with 
this work project, you may wish to enhance your diagnostic 
ability by answering the following OPTIONAL questions. 


15. Is the Fetch System Task currently in control of the systen? 


16. What is the entry address for the Fetch routine? X'* mafane 
17. How many core image blocks are contained on each eract of 
the Core Image Library? ee ee 
18. How many Core Image Directory tracks are supported for each 
PRIVATE Second Level Directory? __ = 
19.. How many Core Image Library blocks are used by the phase 
being fetched or loaded? 


20. What is the name of the phase that was linked the last time 
a "LINK and GO' operation was performed by the Linkage 
| oife I (oo) ody a et ee 
21. What is the disk address (CCHHR) on SYSRES where the beginning 
of the phase $$BJACT can be found? 
Cyl= Hd= = 


EE ETEO AED CLIED RE ET TE SAID SP SS AY RED EEE ERS CLL LOLS IED SERS SD A LS TEP GED ASD > SE a ae es ee: 


22. How big (no. of bytes) is the phase referenced in question 21? 


23. What type of phase (i.e. Self-relocating, SVA Eligible, etc.) 
is the phase referenced in the last question? 


SRE SRD ED EEN CERT eS CD CE? A CED AD cS AS ES 
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ANSWERS TO WORK PROJECT 7 


1. X*6278" (SYSCOM + X*FO*) 

2. X'62FO0' (FTTAB + 0) 

3. Cyl O-Head 2 (FTTAB + X'OA‘) 

4. Assembly (SLD + X'OA*) 

5. 15 (SLD + 0) 

6. Translation Control Block or TCB (As you will see later this 
same work area is used for CCW translation for I/O issued 
from a virtual mode program). 

Te X*QUEEO* CCWTCB1 (The translation control block for each 

partition is always 80 bytes beyond the beginning of its 


SYSTEM savearea). 


8. SVC 4 (SVEARA + X*'58* contains X*880" which is the return 
address to the SVC routine that invoked Fetch). 


NOTE? SVEARA + X'58* is at the label FCHRET in the TCB. 
Refer to the DSECT for the LTA and PP Savearea). 


9. FCHT (The phase name is always placed in the 8 bytes at the 
label CALLNAME which is SVEARA + X'68* or CCWICBX + X'18'). 


10. X*8008C' (SVEARA + X*SC" contains the address of the phase 
name passed to Fetch by the calling program - label CALLPNAM). 


11. 0 (The indication that the phase is self-relocating at 
ENTRYC and the halfword at SVEARA + X*80' both indicate no 
RLD items). 


12. 10 (In the Library Descriptor Entry at a displacement of 
X'OE'. Observe that the descriptor record actually starts 


NN field of the first directory block). 
13. 34 (Displacement of X'10' into the LDE). 


14. 612 (LDE + X'1C' contains the number of library blocks in 
use and LDE + X'1A* contains the number of blocks per track). 


398 


15. 
16. 
17. 
18. 


19.. 


20. 


21. 


22. 


23. 


Yes (SELECT byte contains X'O3*). 

X'*7A50" (SYSCOM + X'10*) (AFETCH) . 

6 (Halfword at FTTAB + 6). 

5 (Refer to bytes 0 and 1 in SLD for each partition). 


7 (The halfword at SVEARA + X'*74" (ENTRYTT) contains the 
number of TXT blocks in the phase. The byte at SVEARA + 
X¥'*78" indicates that it is a self-relocating progran- 
label ENTRYC). 


HISPDUMP - LDE + X'32' contains the first phase name of the 
last program that was linked during a "LINK and GO! operation 
(OPTION LINK). 


Cyl = 22, HD = 16, R = 3 (The directory entry + 8 contains 3 
bytes called the TTR or relative track address for the 
beginning of the phase relative to the beginning of the 
directory. For $$BJACT this entry is X'01C603" which is 
TT=1C6 and R=3. The beginning of the CID is track 2 so we 
must add this to TT and then divide by the number of 
tracks per cyl, 

Xx'1c8" -, xX'14" = 22 with a remainder of 16. 
The remainder is the head value. 


38 (The directory entry + X'0C* indicates the number of TXT 
blocks in this phase. Since that entry indicates only one 
block, the size of the phase can be determined by the 

entry in the next two bytes, that is, the number of TXT bytes 
in the last TXT blocks). 


Self-relocating (The byte at a displacement of X'10' into the 
directory entry indicates this type). 
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WORK PROJECT 8 - PAGE MANAGER 


OBJECTIVE 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Locate and interpret the contents of control blocks used for 
storage management in the DOS/VS Supervisor. 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 
DOS/VS Supervisor Logic 

DOS/VS Base SCM2 

DOS/VS Base Supervisor Listing 


o 
cr 
oO 
p= 
ct 
e) 
ctr 
o 
Wy 
cr 
fon} 
Qu 
3 


Using the WP8N9 Core Dump in DOS/VS Base SCM2, the Supervisor 
Listing, and any additional documentation necessary, answer the 
following mandatory questions: 


ie What are the beginning addresses of the following control 
blocks? 


ae PMGR System Task Control Block Sa 1 SO, 
b. Segment Table (STAB) X'* 

Cz Page Table (PT) X'* 

d. Page Frame Table (PFT) Xt “Leg 1d 
ee Page Frame Table Extension (PFTX) Xe OFES . 
Es Page Queue (PGQU) X! 


ED SAS mE ath a 


Ge Fix Waiter Table (FIXWTAB) x' see 

2~ Which partition was being serviced the last time the PMGR 
System Task was in control? a eee 

3. What are the three main routine names of the Page Manager 
SC a is, ee i Sa 

4. What is the name of the control block that is always used 


to pass information to the PMGR System Task? _ 


SATA CEES APE GSD RES RL ASTD ECCS cS aR REESE 


Ds An entry that is to be placed in the table referenced in 
question 4 is ee initially built at what hex address? 
Xoo 
400 


11. 


12. 


13. 


14. 


Which of the three main routines of the PMGR System Task 
builds the entry at the address referenced in question 5? 


rR ma | 


SA NER ANT AEN ANE NY RE ERLE A EAGAN ETS SERS AN SEED ED SEO END 


In the core dump, which partition was the last to enqueue 
a request for the services of the PMGR System Task? 


Was the partition referenced in question 7 being serviced by 
a system task when this request was enqueued? eee 
What are the four basic request types handled by the PMGR 
System Task? __ 


EF LEED ELEY LIL LIED LITLE SEL ETL LOMLD EDEL GES LEED ALES LIED LEAD SD am. 


Which type of PMGR request was indicated by the last service 
request to the PMGR System Task? ee re 
Is the request that was last built at TRADDR the one that is 
currently being handled by the PMGR System Task? sy 
Which of the three main routines of the PMGR System Task 
deletes a handled service request and posts the requester 
ready to go? 


If the PFIX or the GETREAL routines are forced to wait for 
page frames to be returned to the selection pool, what control 
block is used to save information needed when the routine is 
restarted? 


ED EEE AED TRL CAR TEP ED ATED SEE Le SL AD CLS A ED 


TS LS LET EY TED ED 


What is the virtual address of the page currently being 
handled by the Page Manager for BG in the core dump? 
xe t 


RP SRP ESS EP HC LOEP RAT AAI TED OGD CTO CES AS OTE ED EID 
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OPTIONAL Study Questions 


If you encounter difficulty when analyzing the T/As associated 
with this work project, you may wish to enhance your diagnostic 
ability by answering the following OPTIONAL questions: 


15. 


16. 


17. 


18. 


19. 


20. 


How many partitions were active at the time the core dump 
was taken? ss Masao! are bth ates 

Of the partitions that are active, how many are waiting 
for Page Manager services? _ 


Are any of the System Saveareas in use at this time for ene 
waiting partitions? _ 


OE RD EES LY CTD RENE GATES CG SD A AED ETS aL AERP 


Why is the PMGR System Task in a wait condition? 


- SD Te RE SC eT oneay eR GAM cubed te ope EE ERP OE ET GRD GUE CE OEE IS AS RT SEALERS A ED AED REP ED 


After a request has been handled by the page manager, can the 
entry in the PGQU for this request still be found? 


LAI OR ED 


If a PFIX or GETREAL routine had been forced to wait, which 
two page manager routines are the only ones that could post 
the waiting routine ready to go? 
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The PNGR System Task uses a work area starting at X'ASFC* 
(label PGAD). This area contains information that is of 
significant value when diagnosing PMR problems. PGAD 
contains the virtual address of the PAGE being handled. PFAD 
contains the address of the PAGE FRAME selected by BOCL 

(via the Least Recently Used algorithm). NPTEAD contains 
the address of the new PAGE TABLE ENTRY (the PT ehtry 
associated with the PAGE being handled). CPTEAD contains the 
address of the PAGE FRAME TABLE ENTRY associated with the 
selected PAGE FRAME. OLDPTE contains the address of the 
told’ PAGE TABLE ENTRY when two pages are being exchanged. 
CPTEOF1 contains the PFT offset (displacement) to the 'old* 
page fratle and CPTEOF2 contains the PFT offset to the 

‘thew! page frame when two pages are being exchanged. 


Based on the previous information, answer the following 
questions relative to the request currently being handled 
by the PMGR System Task in the dump: 


aw What is the address of the pT entry associated with 
the page being handled? x*_ 

b. At the time the dump was taken, did this PT entry 
contain the address of the page frame selected by 
BOCL to receive the page? __ __ 

C. What is the real address of the selected page 
frame? Xx‘ __ 

d. Is the selected page frame currently (in the dump) in 
the selection pool? ___ 

e. When the PNR address in the PFT entry for the selected 
frame is eventually plugged into bytes 4 and 5 of the 
PFT entry, what will it be? x! 
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ANSWERS TO WORK PROJECT 8 


1 


6. 


10. 


11. 


12.. 


ae X*2C24* (SYSCOM + X'98"') + (SYSCOM + X*A2*) 

b. X'*DEOO® (SYSCOM + X*DO*) 

Cr X'*D7E8* (First entry in STAB or at the label 'PT'*) 
d. X*CECO* (SYSCOM + X*D4') 

e. X'D6E8" (SYSCOM + X'D8*) 

£. X'9C8C' (SYSCOM + X*11C°) 

vo X'*9D44" (Label FIXWTAB in the SUPVR listing) 


BG (Indicated by the PIK of 10 in byte 2 of the PMGR System 
Task Control Block). 


ENQU, PMR, DEQU 
Page Queue (PGQU) 


X*90" (TRADDR) This fullword is used to pass the virtual 
address to be handled by the PMGR System Task. The entry 

is built at this address and then moved to the first available 
position in the Page Queue (PGQU). 


ENQU (One of the functions of this routine is to build 

bytes 0 and 3 of the entry placed in TRADDR. These bytes 
indicate which user task this request belongs to (byte 0) and 
whether another system task is servicing the user task or not 
(byte 3). Bytes 1 and 2 contain the leftmost 16 bits of the 
address of the page to be handled (inserted by hardware or 

VS management routines). 


F4 (Indicated by the PIK of X'20* stored at X'90" by the 
ENQU routine and by the last request contained in the PGQU 
at X*9C90°). 


No (This is indicated by the F4 PIK of X'20" being in byte 3 
of the TRADDR. If a system task was servicing F4, the 
SELECT value for the particular task would have been placed 
in TRADDR + 3). 


Page Translation Exception, PFIX, TFIX, GETREAL (In order to 
successfully diagnose page manager problems in a minimum 
amount of time, a determination should be made of the 
request type being handled at the time of the failure). 


Page Translation Exception (Bits 4-7 of the first byte at 
TRADDR being off indicate either a PTE or a PAGEIN request. 
The lack of a select byte value of X'06" in TRADDR + 3 
eliminates PAGEIN). 


No (The entry built last is contained in the second entry of 
the PGQU. The request currently being handled is always at 
the start of the PGQU). 7 


DEQU (After removing the last entry from the PGQU, this 


routine turns off the SELECT byte and exits to task 
selection, otherwise it returns to PMR). 
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13. 


14. 


15. 


16.. 
17. 


18. 


19. 


20. 


21. 


FIXWTAB (FIX Waiters Table). 


X'OF8000' (Bytes 1 and 2 of any PGQU entry contain the 
leftmost 16 bits of the virtual address to be handled). 


2 (SYSCOM + X‘'CE* indicates the number of active 
partitions)... 


2 (BG and F4 PIBFLAGS of '87" indicate this). 


No (None of the necessary PIB DAT FLAGS (bits 6 and/or 7) 
have been set to indicate the use of the System Savearea). 


It is waiting for an I/O interrupt (from SYSVIS) as indicated 
by a PIBFLAG of X'82'. The PSW in the PMGR Savearea points 
right beyond an SVC 0 to an I/O WAIT routine. Reg 1 in the 
PMGR Savearea points to a CCB for SYSVIS. 


No (When the first entry in the PGQU has been handled the 
remainder of the entries are shifted up by four bytes, 
overlaying the entry just handled). 


TFREE or PFREE (When returning a page frame to the selection 
pool, the PFREE routine will check the NF bit in the Page 
Frame Table Entry, and the TFREE routine will check both the 
NF and NFF bits in the PFTE. If any of the respective bits 
are on, either routine will then perform the required 
functions which include posting the waiting task ready to go. 


ae X*DBC8" (Contained in NPTEAD at X*A904"*) 


be No (The first 13 bits (0 to 12) of this entry will 


eventually be plugged with the first 13 bits of the 
real address of the selected frame). 

C. X*4pnd000" (Contained in PFAD at X*A900°) 

d. No (Bit 14 (SP bit) in the PFT entry at X'D390' is ON. 
CPTEAD at X'A9O08* points to this entry). 

e. X*OF80* (The virtual address of the page being handled 
divided by 2048). 
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WORK PROJECT 9 — PAGE REPLACEMENT ALGORITHM/LOAD LEVELER © 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Locate and interpret the constants and control blocks used 
to control virtual storage paging activities. 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 


DOS/SVS Supervisor Logic 
DOS/VS Base SCM2 
DOS/VS Base Supervisor Listing 


Directions to the Student 


EP A AP ES A ATT TS 


Using the WP8N9 Core Dump in DOS/VS Base SCM2, the Supervisor 
Listing, and any additional documentation necessary, answer the © 
following mandatory questions: 
1. What is the label of the PMGR System Task subroutine that 

performs the Least Recently Used algorithm? 


> 


2e This subroutine scans the Selection Pool which is made up of 
five chains of entries in what control block?_ 


3. Which bit in a PFT entry indicates whether or not a page 
frame is eligible for paging? ss 
4. To be able to distinguish between each of the 5 Selection 
Pool Queues (chains), 5 Queue Headers are generated immediately 
following the PFT. Each of these headers are 8 bytes long, 
with the top (forward) and bottom (backward) queue pointers 
in bytes 2-3 and 6-7 respectively as are the forward and 
backward pointers in each PFT entry. Each pointer in either 
a PFT entry or a header is the displacement from the beginning 
of the PFT to the entry pointed at (either forward or backward). 


Identify the labels of the 5 Selection Pool Queues. 


nD CS ae ee a EEN eEE) GED Ge ee OED a ao AD TED CD CEE CE a ED aD ee ORD ED Ce cee aD eee ae Tn ee an qe 
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12. 


13. 


The particular queue that is represented by each header 
changes every time a Queue Switch function is performed. 
What is the physical sequence of the 5 labels given to the 
adcons which point to the current chain that each header 
represents? 


aE ESE CAE? GES SENS ELSA LD AIS CTD ELE ELD SITES 


SED Aa Sa (EUSP E> TESS CD NP aD 


SEPRED 


Which two of the five selection pool queues are the only ones 
that are scanned during the Least Recently Used algorithm? 


ES CD TD PEED ED LP ED <FE> aa Cath CREP as) eS OD  <S ae aD 


Scanning of the Q00 and Q01 queues consists of determining the 
Reference and Change bit settings in the hardware storage 
protect stack for each frame represented by the PFT entries 

in the two queues. 


What is the machine instruction that is used to determine 
these bit settings? __ 


CED CED CR GREED RNS DD CED ep CEP CEA CHE GRD HEP Ge CEP aD CaS GL ERD 


What is the label of the one byte field that is used to 
indicate which selection pool queue is being scanned for 
an available frame? ___ 


MG TD OEP HEED ITAL ED PND ISD 


Which of the selection pool queues are currently empty in 
the core dump? 


How many entries are currently in the Q00 chain? i> 
What is the name of the PMGR routine that prevents the systen 
from entering a thrashing condition due to excessive paging 

activity? 


ARE CED CE 


ITED 


What are the names of the parameters used by the Load Leveler 
to measure the following conditions when testing for a 
thrashing condition? 


ae Maximum number of Page-ins per second ___ ot 

b. Minimum number of Page-ins per second ss ti‘ ‘i; 

ome Minimum length of Reactivation-Measurement Interval 

oe Maximum Reentry Rate eee ee eer 

e. Number of Page-ins defining Deactivation-Measurement- 
Interval 


TED RED TEED RED ES GA OTE AEP SE ES CD 


Which supervisor control block contains a pointer to the Load 
Leveler constants referenced in question 12? 
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OPTIONAL Study Questions 


If you encounter difficulty when analyzing the T/As associated 
with this work project, you may wish to enhance your diagnostic 
ability by answering the following OPTIONAL questions: 


14. 


15. 


16. 


17. 


18. 


19. 


20. 


21. 


22. 


23. 


What condition code must be returned by an RRB instruction 
in order for a frame in the Q01 chain to be selected? 


ERE, ERI ELE EATIAELEES INDI ISD IGS LLLP AEDS EL CLES CRED ATES AL ELE SLES ALS CNY AD EBEEAALLTO CALS LEELA EAD TLD 


What is the real address of the last frame for which the 
Page Manager completely finished handling the paging 
activity? 


Which virtual storage control block is used by the PMGR 
System Task to determine the storage protect key value to be 
set whenever paging activity has been completed for any 
frame? 


What is the name of the field used to maintain a count of 
the number of page-ins of pages that were paged out earlier 
in the same measurement time period? _ fo 
What is the name of the bit-string table that is used as a 
page-in reference (compare) in determining the need for an 
increase in the value of the counter referenced in question 
17? ee ee ee ° 

In the core dump, what is the lowest page address of any 
pages that were paged out to SYSVIS within the last Load 
Leveler time measurement? X's * 

What is the count of the number of elements (frames) in the 
Selection Pool at the time of the dump? ree eset 
For the machine configuration from which the core dump was 
taken, what is the maximum number of page-ins allowed per 
second before deactivation of a partition begins? ___ poe 
In the core dump, CCONST contains zeros. What table in 
$IPLRT5 could be changed to put a different value in this or 
any of the Load Leveler constants? 


What is the routine that will be called first to post a 
partition Load Leveler-Bound when the proper deactivation 
criteria is met? 
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ANSWERS TO WORK PROJECT 9 


1. 


2e 


8. 


10. 


11. 
12. 


BQCL (This routine is called by the PMR portion of the system 
task when it is determined that a free page frame is needed). 


Page Frame Table (This control block is used to maintain 
statistics and control all of real main storage. Fach 

eight byte entry in the PFT represents a 2K block (frame) of 
real storage). 


Bit 14 (When this bit is off, the corresponding page frame is 
eligible for BQCL to select it when paging becomes necessary 
(i.e., the frame belongs to (is in) the Selection Pool). 


Q00, Q01, Q10, Q11, HQ 


Q00, Q10, HQ, Q01, Q11 (These adcons are in this physical 
order to accomplish the Queue Switch Function. The adcon 

at Q10 is moved to Q00, HQ is moved to Q10, Q01 is moved to 
HQ, Q11 is moved to Q01, and Q00 adcon (saved before starting 
the switch) is moved to Q11). 


Q00, Q01 (When these queues have been scanned and both are 
found to be empty (no frames selected) the Queue Switch 
function is performed and the scan begins again with Q00). 


Reset Reference Bit (RRB) (This instruction turns off the 
reference bit only and returns a condition code indicating 
the settings of both the reference and change bits prior to 
the reset). 


SCAN (This field contains X'00* when scanning Q00 and X‘'0Q1' 
when BOCL is scanning Q01. Its setting at the time of a 
possible failure in BOQCL may be important). 


Q10 and Q11 (Indicated by the top and bottom pointers being 
equal. These displacements into the PFT are to the headers 
themselves). 


7 - Seven entries are currently in the Q00 chain. 4C0O (D830), 
4C8 (D388), 740 (D600), 4D8 (D398), 750 (D610), 3B0 (D270), 
760 (D620). 


Load Leveler 


ae ACONST 

b. CCONST 

Ce MINTIME 
d. BCONST 

ee NPI 


All of these fullword values are filled in during IPL by 
$IPLRT5 after a determination has been made as to the CPU 
type and the SYSVIS device type (using the DPDTAB). This 
allows a variance for more paging activity on faster’ 
machines. 


4O9 


13. 


14, 


15. 


16. 


17. 
18.. 


19. 


20. 


21. 


226 


2 300 


DPDTAB (Bytes 20-23 contain the address of ACONST). 


Not Referenced but Changed - CC1 (This indicates that the 
frame had been either in the Q00 or the Q01 queue at least 
once during a scan and had been returned to the Q01 queue 
without being referenced again since the last queue switch). 


X'*5pD000" (After a frame has been selected and the paging 
function completed, the PFT entry for the "NEW" page frame 
is inserted at the bottom of the Hold Queue. The bottom 
(backward) pointer in the queue header for the HQ points to 
the PFT entry that was last inserted in the HQ. By appending 
two zeros to any halfword pointer the real address of any 
frame is obtained). 


Page Table (Bits 8 -11 of a PT entry contain the storage key 
of the corresponding partition if bit 13=1 (Invalid). The 
PMGR uses this value for a SSK instruction whenever the | 
corresponding page has been made valid, (i.e., read in from 
SYSVIS or fetched from a Core Image Library). 


RRCTR (Reentry Rate Counter) 

RTAB ( Reentry Rate Table) 

X*E6800' (The first bit that has been turned on in the RTAB 
is Bit 4 of the byte at X*B1B5'. This bit corresponds to the 
page at X*E6800'. This page was replaced in real storage by 


another page within the current measurement interval). 


217 (The halfword at label "NSPE* is used to maintain this 
count). 7 


10 (This is indicated by the value at ACONST). 

LLIPLPAR (Using the CPU and SYSVIS device type codes, $IPLRT5 
determines what entries in this table will be moved to the 
Load Leveler constants). 

DEACTP (DEACT is called to measure for deactivation criteria 


and if it is met, a branch is taken to DEACTP to have a 
partition deactivated). | 
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WORK PROJECT 10 _- CCW TRANSLATION 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Locate and interpret the contents of control blocks used 
during the CCW Translation function of the DOS/VS Supervisor. 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Do ntatio 


DOS/VS Supervisor Logic 
DOS/VS Base SCM2 
DOS/VS Base Supervisor Listing 


Using the WP10 Core Dump in DOS/VS Base SCM2, the Supervisor 
Listirg and any other available documentation, answer the following 
mandatory questions: | 


The WP10 Core Dump was taken at the time a SIO was issued for DASD 
X*131'. The EXCP for this operation came from the F4 program 
VSSDY0O1 running in virtual mode. The program DITTO was also 
running in BGR. 


ue What is the address of the last CCB COPY block used by the 
CCW translation routines? X* ae 

2u Which partition does the CCB copy block, referenced in 
question 1, belong to? = — 

30 What is the address of the Translation Control Block (TCB) 
for the partition referenced in the last question. X' ' 


Use the TCB referenced in Question 3 to answer questions 4 -21. 


W. Is the device that was handled by this TCB capable of 
handling Status Modifier Commands? ___ Bee eee 
So What was the last virtual address peepee to the TFIX routines 
for this I/O operation? X* 
6. At the time the core dump was taken, was the TCB still in use 
(enqueued) ? 
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11. 


12. 


13. 


14. 


15. 


16. 


Has translation for the I/O request been completed? — 
What is the virtual ano Sse of the user's CCB for this I/0 
operation? X* 
What is the address of the first CCW Copy Block in this 
channel program? X*_ act 

What is the virtual address of the first CCW in this channel 
program? x*'_ 

How many Channel Command Words are contained in this channel 
program? ss 
Are there any Indirect Address Lists associated with this 
I/O operation? __—s 
What bit in any CCW indicates to the channel that the data 
address in the CCW points to an IDAL instead of an I/0 
area? BIT 


Are there any pages TFIXed in real core below 384K? _ 


What is the address of the FIXBLK associated with this 
I/O operation? X* , 

What is the address of the nooner Queue Entry for this 
I/O operation? X'* 


SEDES (SUED) SPER CHEE TEP CHORD “SED 


OPTIONAL siudg Ouesbions 


EP ELLY LS LS TAD SED nD a 


If you encounter difficulty when analyzing the T/As associated 
with this work project, you may wish to enhance your diagnostic 
ability by answering the following OPTIONAL questions; 


17. 


18. 


19. 


20. 


2 1.2 


What is the address of the byte, and bit within the byte, 
that indicates to the CCW translation 'SETFLAG" routine that 
the device for this I/O operation is capable of handling a 
SET FILE MASK control command (command code X'1F")? 

xt ‘, Bit 


What is the logical unit associated with the I/O request? 
SYS 


If all of the CCWs that require a 2 byte or larger data area 
crossed page boundaries, how many IDAL blocks would have to 
be enqueued to handle this operation? _ ee 
What is the page frame address of the pene). that has been 
TFIXed for this I/0 operation? X' eee 
Are there any additional I/O requests queued against the 
I/O device associated with this operation? 
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11. 


12. 


13. 


X¥*DERO* (SYSCOM + x'8ut (ACCWT) contains a pointer to the 
CCW translation routine which is headed by three adcons, the 
first of which (ACCBB) is a pointer to the first CCB copy 
block enque ued for all current virtual I/0 operations. The 
first entry in this chain of CCB copy blocks is also the 
last because CCBNEXT at X*DEC4* contains zeros). 


FH (CCB Copy BLK + X'18" contains the PIK of the current 
user of this block). 


X*4FAO" (The respective TCB is always X'50* beyond the 
System Savearea for each partition. The address of the 
System Saveareas are in the PIB table). 


Yes (As indicated by the pointer to the Status Modifier List 
located at TCB + 4 This fullword would contain zeros if the 
device did not support Status Modifier Commands). 


X*FAC83' (Located at TCB + x'30'. This address would have 
been used to free up the TFIXed pages belonging to this | 
request if the TFIX routines ran out of available frames). 


No (There are no TCBS in use by CCWIRANS at the time of the 
dump. This is indicated by the zeros in the adcon AUTCB 

which follows immediately after ACC8B. Had there been an 
address at this location, a search of the chain of TCBs 

that are currently enqueved would have been necessary in order 
to answer this question ( TCB + X*'6C' is the chain pointer). 


Yes (As indicated by CCB Copy Block + X'1A', bit 0, being on. 
This is at label CCBFLAG in the copied CCB). 


X*FACD8" (As indicated by CCB Copy Block + X*1c‘). 
X'DF58" (As indicated by CCBACB (CCB Copy Block + X'20')). 
X'FAD70' (This address is contained at a displacement of 


X'3C* anto the first CCW Copy Block. This fullword in any 
CCW Copy Block contains the virtual address of the first 


CCW in the block). 


9 (Seek, Set File Mask, Search ID Equal, TIC back to the 
Search, Write Count/Key/Data, Search ID Equal, TIC back to 
the search, TIC to the next CCW Copy Block at X'DEC8', anda 
Read Count finishing the chain in the second copy block). 


No (The address of the first IDAL Copy Block would have been 
placed at CCB Copy Block + xX'24"), 


Bit 37 ( The channel will assume that an I/O area does not 
cross a page boundary if this bit is off). 
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14. 


15. 


16. 


17. 


18. 


19. 


20. 


21. 


No (The bit string labeled CCBXINF at CCB Copy Block + X28! 
is used to indicate any pages that have been TFIXed in the 
first 384K of real storage). 


X*DF10" (As indicated by CCB Copy Block + X'40* (Label 
CCBXPTR). 


X*4BDE" (SYSCOM + X*25" contains the address of the Channel 
Queve. The second entry in the queue points to the CCB for 
this operation). 


X'*S8F8E*, Bit 7 (The address at TCE + 8 (DEVCDPTR) which is 
placed there at the beginning cf translation, indicates that 
this device does support some control commands with data. The 
routine, after determining that the current CCW is a control 
command, checks the fullword at DEVCDPTR for non-zero. [If 
satisfied, the routine then shifts the CCW command code 2 

bits to the right and uses the remaining bits as bit 
displacement into the list pointed to by TCB +8. Fora 
command code of Xt1iF', the shift would result in a bit 
displacement of X'07*, (i.e., 00011111 shifted to 00000111). 
Converting the 07 to a mask of 01 for a TM instruction, the 
routine is capable of determining if the byte at DEVCDPTR 

has bit 7 on, and therefore whether or not the device supports 
the Set File Mask control command). 


SYSO04 (Halfword at CCB + 6 indicates Programmer Logical 
Unit Number 4. In the copied CCB at X*DE80', bytes 6 and 
7 provide this information). 


1 (There would only be 2 IDAWsS required for each of the 
five CCWs that have data areas 2 bytes or larger in length. 
Each IDAL BLOCK can contain up to 17 IDAWs). 


X'*73000" (This is indicated by Bit 5 of Byte 4 in the 
FIXBLK being on (address X'DF14*). 


No (As indicated by the channel Queue Entry chain byte of 
X'FFe at X*4BDE'). 
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@ WORK PROJECT 11_=_ SYSTEM PILES ON DISK 


Objective 


Upon completion of this project, the student, using the available 
documentation, should be able to: 


/ 
x. Identify the supervisor generation macro required to include 
es supervisor support for system files on disk. 
2./ Determine the correct use of Jcb Control statements when 
A processing with system files on disk. 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 


DOS/VS System Management Guide 
DOS/VS Supervisor Logic 


Directions - Read the following: 
Considerations When Using System Files _on Disk 


© a Files for the system logical units of SYSIPT, SYSRDR, 


@ 
a SYSIN (which refers to both SYSIPT and SYSRDR), SYSPCH, and 
SYSLST can be created on disk for any batched-job partition. 


® The creation of files on disk for use as system input and 
/ output files is done by user written programs. (Utility 
Ys macros are available to simplify this). 


a Unique Filenames must be specified in DLBL statements for 
/ all system files that reside on disk. 


f T£ SYSRDR and SYSIPT are both assigned to files on disk, 
’ their files must coincide (reside in the same extent) and 
Jf SYSIN must be specified as the symbolic unit in an ASSGN 
Statement. 


Job Control issues an operator warning message when the 
area (extent) assigned to disk for SYSLST or SYSPCH approaches 
NS a predefined residual capacity. 


e Residual capacity limits are established at supervisor 
generation time via the FOPT MACRO (SYSFIL=parameter). These 
. values can be changed after IPL by the Job Control SET 
“statement (RCLST and RCPCH operands). 


e System files, when on disk, are supported by use of the 
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Job Control statements ASSGN and CLOSE, and by the supervisor channel ® 
scheduler routines. 


e Job Control, through the use of the ASSGN statement, 
OPENS a system file cn disk and initializes a disk information 
/ block (DIB table) within the supervisor. (See DIB Table in 
the DOS/VS Supervisor Logic PLM). 


e Each time a problem program requests an I/0 operating on a 
system logical unit, the supervisor checks the DIB table for 
a valid seek address. (Note that the job information block 

vA (JIB) is not used for system files on disk). After each 
successful access to the file, the supervisor updates the 
current address field in the affected DIB. 


When a problem program issues an OPEN to a system file that 
is currently assigned to disk, the LICCS OPEN routine 
transfers the EXTENT information to the DTF table from the 
/ DIB, instead of from the file label in the volume table of 

contents. This causes the current address field in the DIB 
to be used as the beginning extent for the DIF of the file 
being opened. 


e When a problem program closes a system file that is assigned 
f to disk, the LIOCS close routine posts’ the file closed and 
does not disturb the DIB. 
e Job Control, through the use of the CLOSE statement, must 
/ be used to close system files on disk and to deactivate the @ 
DIB. 


e Tf only the SYSRDR or SYSIPT file (not both) is assigned to 
a disk extent, the filename IJSYSIN must be used in the DLBL 
statement and SYSRDR or SYSIPT must be specified in the ASSGN 
and CLOSE statements. 


e If both SYSRDR and SYSIPT files are assigned to a disk extent, 
they must occupy the same extent and be referred to as SYSIN 
in the ASSGN and CLOSE statements. In this instance, the 
filename IJSYSIN is also used in the DLBL statement. 


SYSLST and SYSPCH files must occupy separate extents. Thus, 
SYSOUT may not be used to refer to a combined SYSLST/SYSPCH 
on a 2311, 2314, or 3330. 


e Assignment of system logical units to disk extents must be 
permanent. The permanent ASSGN statement (no slashes) must be 
used instead of the temporary statement (//ASSGN). Temporary 
assignments (via the // ASSGN statement) to other device types 
are permitted. Thus, a job not in the input job stream on 
disk could be run by causing a pause at the end of the current 
job, temporarily assigning SYSRDR to a card reader or a 
magnetic tape unit. 


e Specification of the system generation parameter SYSFIL= is 


required to allow assignment of system logical units to a 
disk. It provides the capability of warning the operator when 
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/ SYSPCH and SYSLST files on disk reach a certain (specified 
© / OLY assumed) capacity. Note that this warning is given after 
\/ the job ends, and that if the extent limits are exceeded 
before end-of-job, the job is terminated. 


? 


e “System input and output files are assigned to disk by 
“ providing a set of DLBL and EXTENT statements, and then 
submitting a permanent ASSGN statement. The set of 
Ww DLBL and EXTENT statements preceding the ASSGN statement may 
contain only one EXTENT statement. 


® The filename in the DLBL statement (which is associated with 
he SYSxxx entry from the accompanying EXTENT statement) must 
e one of the following: 

/ 


= IJSYSIN for SYSRDR, SYSIPT, or a combined 
/ SYSRDR/SYSIPT file (SYSIN) 


a IJSYSPH for SYSPCH 
= IJSYSLS for SYSLST 


SD (or blank, which defaults to SD) to indicate sequential 


* / 3 the DLBL statement, the ‘codes' operand must specify 
@ DASD file type. 
® yin the EXTENT statement, ‘type' may be 1 (data area, no split 
/ cylinder) or 8 (data area, split cylinder). There is no 
oe unigue requirement for the remaining operands of the EXTENT 


statement. 
® The ASSGN statement must be one of the following: 
wr - ASSGN SYSIN,X'cuut (for a combined SYSRDR/SYSIPT 
file) 


= ASSGN SYSRDR,X'cuut (for SYSRDR only) 
_ ASSGN SYSIPT,X*cuu! (for SYSIPT only) 
7 ASSGN SYSPCH,X'cuu! (for SYSPCH) 
- ASSGN SYSLST,X'cuu' (for SYSLST) 


NOTE: All assignments must be permanent (not preceded by //). 


Upon encountering a system input or output assignment to a 2311, 
2314 or 3330, Job Control performs the following functions: 


© Rejects the assignment if is is not permanent. 
® Rejects the assignment if a previous assignment to a 2311, 


2314 or 3330 for the same logical unit still exists (has not 
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been closed). Also, because SYSRDR and SYSIPT must be a 
single combined file if both are on disk, one cannot be 
assigned to disk if an assignment to disk for the other (or 
both) already exists. 


® OPENs the file. If input, the labels are checked. If output, 
DASD labels are written. Also, information is placed into the 
supervisor disk information block (DIB table) for the problem 
program OPEN, and for monitoring of file operations by physical 
IOcs. 


e If the OPEN is unsuccessful, Job Control unassigns the unit 
and requests further operator commands. 


ne a eam a ae 


@ System logical units assigned to disk must be closed by the 
operator. The operator CLOSE command must be used to specify 
a system input or output file which has been previously 
assigned to a 2311, 2314 or 3330. The optional second 
parameter (X'cuu') of the CLOSE command must be used (instead 
of an ASSGN command) to assign the system logical unit toa 
physical device. The system will notify the operator that a 
CLOSE is required when the limit of the file has been 
exhausted. If a program attempts to read or write beyond the 
limits of the file, the program will be terminated and the 
file must be closed. 


@ The CLOSE function: 


~ Writes a file mark if the file is an output 
file. 


~ Resets the DIB table in the supervisor to indicate 
that the file no longer exists. 


- Reassigns the logical unit to the value of the 
second operand of the CLOSE command. 


NOTE: The CLOSE command must specify SYSIN if the file 
being closed is a combined SYSRDR/SYSIPT file 
(ie, CLOSE SYSIN,X"00C'). If only SYSRDR (or 
SYSIPT) has been assigned to disk, the CLOSE 
command must specify SYSRDR (or SYSIPT). 
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FopTt Macro Parameter for System Files on Disk 


SYSFIL= 


NO 
YES 
(YES,n No) 


Specify YES if system input and systen 
output files (SYSRDR, SYSIPT, SYSLST, 
SYSPCH) in any partition may be 

assigned to a disk device or, if support 
for the procedure library is desired. 
Specification of YES gives support for 

all disk devices and the IBM 3540 Diskette 
Input/Output Unit. In a configuration 


is required for system maintenance 
purposes. If the emulator program para- 
meter SYSIO is specified with a value 
ranging from 200 through 233, a value must 


be specified for SYSFIL. 


i) 


ny residual capacity limit at which 

point the operator is notified when 
SYSLST assigned to disk. The value 
for ny must be at least 100 and no 
more than 65535. If ni is omitted, 


1000 is assumed. 


n2 residual capacity limit at which 
point the operator is notified 
when SYSPCH assigned to disk. The 
value for ne must be at least 100 
and no more than 65535. If no is 


omitted, 1000 is assumed. 
Notes: 


1. If neither ni or n2 is specified, 
the operand need not be placed 
between parentheses. 


2. Neither ny Or No may be specified 
if the logical units are assigned 
to an IBM 3540 Diskette Input/Output 
Unit. 


3. The Job Control SET command can, 
through the use of the RCLST and 
RCPCH operands, change these ‘'n! 
values at any time. 
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Significant System File Error Messages 


1A0nD 


INVALID I/0 ASSIGNMENT 


n indicates the field processed when the error was 
detected. 


Causes 


Previous ASSGN specified invalid logical 
or physical unit, or 


*Previous ASSGN attempted to assign the IGN parameter 
SYSRDR or SYSIPT, or 


*Previous ASSGN attempted to make a temporary 
assignment to SYSPCH or SYSLST when there was 
already a SYSOUT assignment, or SYSOUT has to be 
used. See DOS/VS System Management Guide, under 
Symbolic I/O Assignment, or 


Previous ASSGN attempted to make an alternate assignment 
to a logical unit currently unassigned, or 


*xPrevious ASSGN attempted to make an alternate 
assignment to SYSOUT when SYSOUT cannot be assigned. 
See DOS/VS System Management Guide, under Symbolic 
I/O Assignment, or 3 


*Previous temporary ASSGN attempted to assign SYSRDR, 
SYSIPT, SYSLST, or SYSPCH to a disk extent. See DOS/VS 
System Management Guide, or 


Previous ASSGN attempted to make a 
temporary alternate assignment to a logical unit 
in standard mode, or 


Previous ASSGN attempted to make 
a standard alternate assignment to a logical 
unit in a standard mode, or 


Previous // ASSGN attempted to unassign SYSCLB, or 


Previous ASSGN attempted to make a temporary assignment 
for SYSCLB, or 


Previous ASSGN attempted to assign the IGN 
parameter to SYSCLB (See DOS/VS Operating 
Procedures or DOS/VS System Control Statements), or 


Previous ASSGN attempted to assign SYSCLB or a 
private core image library currently being 
condensed in another partition, or 


Previous ASSGN attempted to assign SYSCLB to a 


private core image library already assigned to a 
partition where a compile, link-edit, and go is 


420 


taking place, or 


*There is no SYSFIL support in the supervisor. 


System Action: If SYSLOG is assigned to a keyboard, 
the system waits for an operator response; otherwise, 
the invalid assignment is ignored. 


Programmer Action: none. 


eee ce A ATT: AS TS aN A NN | 


Operator Action: Issue the LISTIO command for both 
the physical and logical unit referenced by the 
assignment that caused the error. Check for any of 


the following errors: 
An invalid physical or logical unit. 


*The IGN parameter in an assignment for SYSRDR, 
SYSIPT, SYSIN or SYSCLB. 


*A temporary assignment for SYSPCH or SYSLST when 
SYSOUT is assigned to a disk cr magnetic tape. 


*An alternate assignment for SYSOUT when SYSPCH and 
SYSLST are not assigned to the same disk or magnetic 


type. 


*Sysfile related 


1A 1nD 


CONFLICTING I/O ASSIGNMENT 


n indicates the field processed when the error was 
detected. 


Cause: Previous ASSGN attempted to assign a 
logical unit to a physical device already assigned 
to another logical unit with a conflicting function. 
For example, no physical device can be assigned to 
both SYSOUT and SYSIN. 


System Action: If SYSLOG is assigned to a keyboard, 
the system waits for an operator response; otherwise, 
the invalid assignment is ignored. If option 
ACANCEL is in effect together with the NOLOG 


command, the system cancels the job. 
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Programmer Action: Use the LISTIO output to correct 


the assignments. 


Operator Action: Enter a new aSSignment, or 
Use the LISTIO command to obtain the current 
assignments, check the assignment in question, 


and make the necessary correction, or 


Issue the LISTIO command, then type CANCEL to 
cancel job, or 


Type IGNORE or press END/ENTER to ignore the 
assignment if you can do without, and continue 
processing. 


If the problem recurs, have the 

e Log sheet 

e LISTIO output 

available for problem determination. 
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® DIB (Disk Informat ion Block) 


A DIB is built at generation time if the option was selected. It 
performs a recordkeeping function on system class units assigned 
to a DASD. The DIB contains the current seek address for all 
system files on disk when the system is operating in a batched-job 
environment. 


A DIB clock is initialized by Job Control with extent information 

and updated by physical IOCS. When the PCIL option is used, the 

DIB is updated each time the PCIL is assigned. 

There is one DIB table for each partition. Label DSKPOSBG identifies 
the first byte of the BG DIB Table (DSKPOSF1, DSKPOSF2, DSKPOSF3, 
DSKPOSF4, for the other partitions). The addresses of the DIB 


tables are contained in bytes 96 and 97 (X‘'60' and X*61") of the 
appropriate partition communication region). 


DISK INFORMATION BLOCK (O18) TABLE 


BG DIB 
Table 
F4 DIB 
Table 
F3 DIB 
Table 
F2 DIB 
Table 
FI DIB 
Table 
The number of DIB tables depends 


on the number of partitions speci- 
fied at supervisor generation. PRCDIB 


DSKPOSBG 


Format of any DIB table if ag YES 
0 


Current Address 
DSKPOSF4 


DSKPOSF 3 


} DSKPOSF2 


DSKPOSF 1 


PRCDIB 


®) BG SYSLNK DIB contains the PUB pointer for CLB. 
For FG SYSLNK DIBs this byte is unused. 
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DIB TABLE 

Bytes 

O-6: Current Address 
0-5: Current address of key: the next address to be 

used (both for input and output). 
6: Record number of current address. 

7-9: KDD 
Key and data length of the symbolic device. PP: starting 
cylinder of Private Core Image Library if PCIL is 
assigned; otherwise zero. 

10-16: End_Address 
10-15: End address of key: the last address within the 

the limits of the extent. 
16: Record number of end address. 

17 : UL Upper head limit. 

18 : LL Lower head limit. 

19 : M Maximum number of records per track. 

20 : RC Record count: Residual capacity limit at which 
point the operator is notified. Set at system 
generation time with SYSFIL parameter, or after IPL 
with SET statement (RCLST and/or RCPCH operands). A 
warning message is issued by Job Control after End- 
of-Job step when the minimum number of remaining 
records has been reached or exceeded during the 
previous job. Not supported for 3540. 

22 : Utilized for RPS (X'40"'=RPS device). See Release 30 
Update. 

23 : Reserved. 


Answer the Following Mandatory Questions: 


i. 


2s 


What parameter of the FOPT macro will allow the use of 
system files on disk? ___SWMAL= YES __ 


Which system files on disk are referenced when SYSIN_is used 


in an ASSGN statement? aS MSR SYeTPT 
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10. 


When SYSOUT is assigned, what symbolic devices are used? 


___DHECOH a SUSLST 


What filename is used in a DLBL statement to, identify a 
combined SYSRDR/SYSIPT file on disk? __ TJSYSIN 


CS CED AE IRE TEE ARTE eR I ORE ED OTS eRe ERT ene SPY EA A EDD TED a A AR OE? ND Sein emt ete atED 


A A AS ee ANOS AP TD AS ED 


Write the JCL statement that would be used to assign SYSRDR/ 


SYSIPT to a disk whose address is 191. BABGng SUSIN, X' 444 


What is the length of a record read from SYSRDR on disk? SD 
What is the length of a record read from SYSPCH on disk? 3B 84 


What filename is used in a DLBL statement to identify only 
the SYSRDR file on disk? __ TSSYSIA 


(<nu8e ARO oe GED ane eT ae QR ee ee se eee 


Write the JCL statement that would be used to close a SYSIPT 
file on disk and reassign SYSIPT to its conventional IBM 


device address. _00 FS CUSE$ 4a)PT X pc’ 


The ASSGN statement that assigns a system symbolic unit to a 
disk device must always be read (before/after) the DLBL and 
EXTENT statements that define the file. 


Why? 


PAE ERD ED ED EEE AENEID aS ETN AD CERES SD TT EES CED AOE AED PE SEED GE RD ED SR EDD SER A ED ORI GEE NE EEE Ry EOD ai EY ENED POSTED EE ES ITD ED aD TEE 


PEED CES ES AE ED ATED RS END ED RSAEED COUN GETS SIMMOD GREENS AEE SRE CME MEGS LES CE CUE AE ID AE GD RED ES NS EE ED SES ED PR ARES ED Gee TEE SREP TD CEE I OED ED SP ES GE RS SN SE aD a EE EAD SER OE ED 


1. SYSFIL= 

2 SYSRDR, SYSIPT 

3% SYSPCH, SYSLST (only if they are assigned to tape - SYSOUT is 

not valid for disk). 

4. IJSYSIN 

5. ASSGN SYSIN,xX'191°* 

6. 80 

Ve 81 

8. IJSYSIN 

9 « CLOSE SYSIPT,X'0O0C! 

10. After; The filename and extent information must be available 
at assignment time because the ASSGN statement for a 
system file on disk actually opens the file. 
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Upon completion of this project, the student, using the available 
documentation, should be able to: 


1. Locate and interpret the contents of the Shared Virtual Area 
and the control block used to pass information to the library 
directory maintenance phase, S$MAINDIR. 


/ 


Time required to complete this project averages 1.0 hours. 


Tools, Test Equipment and Documentation 


DOS/VS Supervisor Logic 
DOS/VS Base SCM2 
DOS/VS Base Supervisor Listing 


Directions to the Student 


Using the WP12 Core Dump in DOS/VS Base SCM2, the Supervisor 
Listing, and any other available documentation, answer the 
following mandatory questions. | 


The WP12 Core Dump Was forced at the time the linkage editor was 
to branch to SMAINDIR. 


ue What is the address of the Shared Virtual Area? Xx' : 


TE Cee a EE eR 


2a What is the beginning address of the System Getvis Area? 
Xx? ] \ 


SF EE LPARD CPD EY EP SRD APD a? 


3. How many bytes are there in the System Getvis Area (SGA)? 


Ep aE EN a SITE LE TS I EI” AMEE 


4. Is the System Directory List (SDL) active at the time of the 


dump? 
ore What is the maximum possible number of SDL entries? _ 
6. What is the start address of the SDL? X*_ ¢ 


7. What is the length of the SDL in the core dump? 


8. Of the twenty-seven directory entries in the SDL, which 
two currently have their phases in the SVA? 


427 


11. 


12. 


13. 


14. 


What is the CurECtS entry point address for S$MAINDIR? 
Xx! 


TEL ATEN AREY RTCA ITA are 


What is the address of the STOW table being pansed to 
$MAINDIR by the Linkage Editor? X'* 


What is the name of the phase that is being passed to 
$MAINDIR in the STOW table? 


a > me 


Which function of the Linkage Editor was requested in the 
OPTION card for the Linkedit run in the core dump? 
// OPTION 


cn a, a cE ee 


EP CES CANAD SGP OATS IE TEE RED 


What is the address of the beginning of the SVA library? 
) een ene ce ee 

How many bytes are available for additional phases in the 
SVA library? 
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ats 
12. 
13. 


14. 


X*13B800" (SYSCOM + X'F5* contains a pointer to the SVA) 


~x'16D800" (SYSCOM + X'F8" contains a pointer to the SVA) 


51200 (X'C800') (This is the difference between the beginning 
address of the SGA and the end address of virtual storage. 
The end of virtual storage address can be found in the 


Boundary Box + X‘0C*). 


Yes (SYSCOM + X'F4* contains the SVA FLAG byte. Bit 1 being 
on indicates that the SDL is active). 


963 (32K is the maximum size of the SDL. Each entry 
requires 34 bytes). 


X*13B822" (As indicated in the SVA Constants Area at the 
Supervisor DSECT LABEL 'VDSA*). 


954 bytes (As indicated by the value in the first two 
bytes of the SDL). 


SLIBSTAT, $MAINDIR (AS indicated by Byte 16, Bit 3 being on 
in their respective SDL directory entries). 


X¥*13D000' (As indicated by bytes 31-33 of the directory 
entry). 


X*84B50" (The address of the STOW table is always passed in 
General Register 0). 


DANSPHAZ (As indicated by the first eight bytes of the Rha Se 
entry in the STOW table). 


// OPTION LINK (As indicated by the L (X'D3*) in byte 17 of 
the STOW table entry (X'84B6D"). 


X*13BBE0* (AS indicated in the SVA Constants Area; SVA + X*0C! 
(VSLA). 


188464 (2E030) (This amount is the difference between the 
Next Available Entry in the SVA Library value at VLNA 

(SVA + X'10"), minus 1 and the End of the SVA Library value 
at VLEA (SVA # X'*14°"). 
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Objective 
Upon completion of this project, the student, using the available 
documentation, should be able to: 


“Ve Locate and interpret the contents of the following areas in a 
DASD PRINT of an indexed sequential file. 


The MASTER INDEX 

The CYLINDER INDEX 

The TRACK INDEXES 

The PRIME DATA AREA 

The CYLINDER OVERFLOW TRACK(S) 
The INDEPENDENT OVERFLOW AREA 


Time required to complete this project averages 2.0 hours. 


DOS/VS System Control Statements 
DOS/VS Data Management Guide 
DOS/VS LIOCS Volume 3 

DOS/VS Base SCM 3 


Directions to the Student 


Using the listings for ISLOAD ~- ‘Job Stream To Execute Program’ and 
ISADRTR - 'Job Stream To Execute An ADD Operation’ in DOS/VS Base 
SCM 3, answer the following questions relative to the ISADRTR - 
'Pile Dump Via DASD PRINT After ADD' (also in DOS/VS Base SCM 3). 


A layout form on which you can map the contents of the ISAM file 


contained in the ISADRTR DASD PRINT is located immediately following 
the questions for this work project. 
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QUESTIONS 


1. 


3. 


For each of the specified AREAS, fill in the EXTENT INFORMATION 
as determined from the label set contained in the job stream 
listings. 


AREAS EXTENT INFORMATION 

Cylinder Head Cylinder Head 
Master Index te sie te GOP ene el St ta ent 
Cylinder Index Be hee ets eerie, OO eee Be at 
Prime Data rete bia tatty ee ReGPENO”  h tothe ee hee Nee 
Independent Overflow to 


(a) What is the disk address (CHR) of the normal track index 
entry for the fourth track in the prime data area? 


— —_ — 
—- —_ — 


(>) What is the key of the first record on the track to which 
this track index entry points? KEY= 


UEP AMES AED ED PETES TROUT AE GERI 


(a) What is the disk address of the overflow track index entry 


OED CHEERED ALE GELOCBTED CELIO ALLE SEED 


for the first track in the prime data area? 


am URE ED exces a ery EE NE A RD A <P SaD YOR GSE a 


(b) To which overflow area is this track index entry pointing? 


EEE? SEE AEP EER SERED aD SNEED GUEY eaNeTD CN o> CAE SGP 


(c) What is the key of the record to which this track index 
entry points? KEY= 


LP AED LP ALS PLY STS AT TY TOD AD CL AY 


(a) What is the disk address of the normal track index entry 
for the 25th track in the prime data area? 


— —_ — 
—— Seal —_ 


FED EP ED CUD ALAEY SNM ED ATED SSG CEES 


(b) What is the key contained in this entry? KEY= 
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9. 


10. 


(a) At what disk address is the cylinder overflow control 
record (COCR) located for the first cylinder in the 
prime data area? C= _ = = 


Teel ae ly ane ane anes ane o> een ope 


(b) What is the significance of the first three bytes 
(x'001312"') in the data portion of this record? 


eee) qe, Ce qe RD Ee i OR ep I CED ED ED ID Ce CRD eR COED EEE SETEP SEED ED CIEE CRED ED GE ETD GE ED REDON ee GP TEED EE AED CED GED ED 


EP ED ED CD A AER TOD A TOY AN LY ID SD A IT ED I CTD SY TL TTS OD SE LE ALD TD TE: SS A OE AT TS ST Ae SS ED NS AS 


SAND CED TED REED SED AEEP TO CED SEN NGS RED CEP ARE GR ED TE CE A ES CS NP ED AS ED A A a aS AD PS ES A A PD NE a AP NY ASE LS A A 


What is the disk address of the last record 0 in the 
independent overflow area extent? 
C= H= R= 


ae ae 


(a) The data portion of the record at cylinder 151, head 
00, record 02 can be described as which of the following: 


Sequence - Link Field 
Index Level Pointer 


2p Ee 


Cylinder Overflow Control Record 


a ane 


(b) The byte within this field that describes the type of 
entry contained in this record contains what hex value? 
Xx" ___' 

If the ninth byte in a sequence - link field or index level 

pointer contains X'10', what type of entry is contained in the 

record? 


SD END ETUDE CED RD ea AD EE AE ND SD SS A OS A A TY a A DS PS AD OY PS A Ty Ny A ES 


What is the disk address of the record that contains the 
overflow end entry for those records that have overflowed 
from the first track in the prime data area? 


In the record at cylinder 160, head 19, record 05, what is 
the significance of the first byte in the data portion of the 
record (X'02')? 


0 ED ES I CED UEP ORNS ED ND Ee CD ED ED ED ED EE ED OEE EEE CAEP OE CEED GED ED CR GDC CS EE AED CED <P EE 
ED Ee ED EE, EE END ENS EES EE ED ED SERED ENED END ORD EF EE, NS AE EE AS ED A: ND TS OY AD EY ED OD EE AD LE LG ES TL TD OL TL LD II 


RE ED CoD ED ENED SITE NS A ES OT SD TD LD LS IE NS PY Ce A A A A NS A LS SS SS TS AD A AD PLY SPS RSS PLES RY AP EY ED CLAD ED REP ERED 
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11. 


12. 


13. 


(1) 
(2) 
(3) 
(4) 
(5) 
(6) 
(7) 


(8) 


(9) 
(10) 
(11) 
(12) 
(13) 
(14) 
(15) 
(16) 
(17) 
(18) 
(19) 
(20) 


What is the significance of the first byte in the data area 
portion of the record at cylinder 155, head 00, record 04? 


ae 


GE TEES CREPES CAREERS GP ENED SAD eh aD CS ERD RAGS etEETD oI? CED RCE EEE ED ED GED ED a aS ae 


What is the significance of the first byte in the data area 
portion of the record at cylinder 160, head 01, record 14? . 


FED ED AED ELD ELD ETDS, LITE ALLA ELROD LEELA CLE CETTE LE LEED IED LEE LE LID CLEP AL AEELY IS TLD LY ET AG ED SED CES CELE AREY ED AAD OLED AES EAL TONES CEPTS MS AE LET ED ALLS SPST TED ID ETD AED OGD) 


SE CED TED CRIED GPE SECA SEP CoD eet ED CER ER) aT ESIES> Cintas EROS CER EES EAD TIDES AD GEE IS AED TY SEED ENS REED CET ED EE EID EEE TEED AED EA GREED AETED OND ED CED GE SYS CAD CAD GEE EE <RAD aED 


Starting with the MASTER index, list in sequence the disk 
address of each and every index and sequence - link entry 
that must be referenced in the DASD PRINT to locate the 
logical records whose 'keys! are listed below. 


First Record Second Record Third Record 
000099 


KE Y=00000010 KEY=00000109 KEY=00 


Ia 
fom: 
\oo 
Ia 
ps 2} 
iro 
IQ 
feo} 
> a) 


150 _00 _01 150 _90 _01 150 _900 _01 


FID EE ETS ap Gears eee eel PED AD SD EP CTL AID CED Ean ia GE Ci CREED AERP AEETEED 


— EP EERE ED LD LD REDD GE ED a cm GD a ED qn ao oP oe EP aD a 
EF ER TP ap PD ED TLD ERED ome a eS a ED OS CRD a a TD TD TD SET 
aD tee EE EERE nem aa» EE ERS I Oa EE —- oe a> TD AT OE 2D ee uP Ee SIE SOE 
oe ae ae DED AR PEERED ES ES ED a SeDonss ane Ea EP OES ae a GD cae 
EEE BER Pea ICR EE CENT a aan ER SUED SETS > cp a ES can amITeEP } wskide eee cae c= AD OY TD ITIL 
ER RD TEE EP EEE RR AED <p curry ane <PEemap re DED ED ED ETD CE a ep ED ECD ERD 
EM BD TD EP CESS SE CE FRED ES ED EE? ES SEE CE ED oh aD DEED an DATED CHI 
ES RAD CHD SEED oe eacee TD EG ED EDEN CD ea a MED ED ee ee GED oe aE one 
ED ED TD SEED IE CS ED Cae <P> eer alam Sent enue amenD mane wee op eane ee me aS ores RUD ED OED 
Eee aaa a ER TERT REO ERTS ET oy cam eta CRORE CIR OO a ape MURS AES oe ara CES TR 
ED EER CET ET CEE RAED amas aa RED CED ARC FS ae ERS ee tee Crete aD ED LT SRD ERE) CREED aes 
UP? - D eae VERS OEP I ty eee erence NN iE CO AEE aD ae Ga ee etm <i ensue 
bean ety ee apa en ape ane <a ee Oe TER SEP Eo CRD aE ema? saa ean ce we oe CRIED ERED 
ID ED ED ER TD ED ER EO ED ae EES a ae a amp eae cE cis a oa ee 
FALLS ES RED EE ATED Pea nan ==> ame «ae ee SD ARES CREE ER SER ETS ERED CSI IAS ED 
> a a > aD —_— a oD —Hae oP eo RS LPT —-— an ee rae Cr aa 
amp an aa LEED AT RLY EP EAD ENTS (SE CD (SESRe ce REE DS PS SED UD EE ED 2 «ecu SEDO 
EP SERED COED ASTER CED EE EP ED END AED ED ea RORED rire cua oe SD SE ED EE ee aah 
TGP cuRTE eet EP EOE UEP ESE ee OED ED aD <7 oie CS ee ee EETe aE come ep ae om [Eee eee 
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14. 


15. 


(a) 


(b) 


(c) 


(d) 


(a) 


(b) 


If a record whose key is '00000147' is added to the 
file, at what disk address would it be inserted? 

= H= bee eee ee R= Pere 

What is the key of the record that would be displaced 
by the new record? KEY= 


What is the key of the record that would be forced into 
the overflow area? KEY= 


SeEko Hum ate ED ED TS SER ED 


At what disk address in the overflow area would this 
record be placed? C= = = 


Why? 


BED GY ADI OLTELY EES LGD SLY CDE ERD, CRD (SAT AE CP EE OEE CS CLLEE LD CY ES MET EEE VILLE EELS SE CLIELS SLED DLS SEI RELIG CEL SERRE LTD CALE LN LIED ELLIS SONEY IED LED COGENT HTD 


EES GED ATE OAD ASD CREED aE CHER TCAD CD CEP CORD CT CORES ED EES SURED nie ED EE A CMAP EAA CR A TE A SES AP SA LD CTS ALAR CLE SLI TD 


AD SRS OAS aaa CAE RE AO EP CY AS ESRD A ROTTED TED OED ARDS ED AE NED aller SAEED EES END CD SETS RED SPGED aaa STAD ENS LUNE CRED STD CAPRA TS ED 


How many ‘overflow end* entries are contained on cylinder 
160, head 19? — Pens 
At what disk address is the ‘overflow end! entry located 
for the chain of records that overflowed from the third 
track in the prime data area? 


= = R= 


EY ED AAS LP a> EP SD ane? EE > SE ee aD 
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PRIME DATACYLINDER [__ ] 
INDEPENDENT OVERFLOW CYLINDER [__] 


e— Twto —~._, 


Work Project 13 - Layout Form for Mapping the ISAM File 
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ANSWERS TO WORK PROJECT 13 @ 
Cylinder Head Cylinder Head 
Master Index _.1590  =9+=_90_ to ners WOO.- 1 NI. 
Cylinder Index | _1!t = _¢d to iO. SUS 2 
Prime Data a VEC... (0. 40 weet OV: i Oe 
Independent Overflow 15 _CO_ to Sse ns, Ou 


2a (a) C= 160 H= 00 R= 07 (this is the location of the normal 
track index entry for track 03 on cylinder 160). 


(b) KEY= 00000198 (1st record on track 03 of cylinder 160). 


3. (a) C= 160 H= 00 R= QO2 (this is the location of the overflow 
track index entry for track 00 on cylinder 160). 


(b) Cylinder (Cylinder 160 - Head 19). 
(c) KEY= 00000008 (2nd record on track 19 of cylinder 160). 


4. (a) C= 161 H= 00 R= 99 


(b) KEY= 00000000 (this entry is not active because there are 


no records contained on track 4 of cylinder 161). 


De (a) C= 160 H= 0O R= 00 
(b) These bytes point to the last record that was written in the | 
7 overflow area for this cylinder (in this case head 19, record @ 


18 of cylinder 160). 


6. C= 155 H= OY R= 00 (The independent overflow extent specifies 
only 5 tracks. Records 0 for heads 5 to 19 do not fall within 
the extent specified for the independent overflow area. These 
records were printed only because the DASD PRINT program was 
instructed to print the contents of heads 00 to 19 on cylinder 
155). 


Ts (a) Index Level Pointer 
(b) xf21° (Refer to 'F' character breakdown (ccccciii) in the 


chart ‘Format of Sequence - Link Field/Index Level Pointer’ 
contained in DOS/VS LIOCS Volume 3). 
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Overflow Entry (End) 


C= 160 H= 19 R= 01 (The key of the record at this disk address 
is '00000014'. This record was originally the last record on 
cylinder 160, head 00 when the file was created. Because of 
added records (7, 8, 9, 10, 11, 12,eand 13), it was moved to the 
cylinder overflow area and is the last record in the overflow 
chain from head 00). 


The X'02' indicates that the disk address contained in the 
sequence - link field falls within the prime data area extent 
(EXTENT sequence number 2). 


This byte indicates that the disk address contained in the 
sequence - link field falls within the independent overflow 
area extent (EXTENT sequence number 3). 


None as far as ISAM is concerned (this X'*F2' is simply the first 
byte of the users data record). 


First Record Second Record Third Record 

KEY=00000010 KE Y=00000109 KE Y=00000099 
Cc H R c H R ie H R 
459 _00 _01 450 _00 _01 150 00 _01 
4151 _00 _01 451 _00 _01 151 _00 _01 
160 _00 _Q1 160 _90 _01 169 _00 _01 
160 _00 _02 160 _00 _02 160 _90 _92 
160 19 _02 160 _00 _03 160 _00 _03 
160 _19 _03 160 _99 _04 160 _00 _04 
60 _19 _04 160 _90 _95 160 _19 _17 
aiid, eee Aeniae 160 _92 _01 160 _19 _16 
pha, poets ees 1690 92 92 160 _19 _15 
Lr aera 160 _02 _03 (160 _19 _18 
Sa Meret geese 160 _02 _04 155 _90 _01 
Sealy ee aa 160 _02 _95 160 _19 _14 
eee ee ee 160 _19 _13 
ek peeps eeee eee eet eee es 160 _19 _12 
piss, wate, dash POTEES eae SRO 160 _19 _11 
sie Pies Sie eit ete State 160 _19 _10 
eee ae ee es, ee ee 160 _19 _09 
160 _19 _08 
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| 


14. 


15. 


(a) 
(b) 


(c) 


(d) 


(a) 


(b) 


C= 160 H= 02 R= 15 


ae ae Gp pee 


KEY= 00000169 

C= 155 H= 00 R= 8 (The cylinder overflcw track is full and 
this is the next available record location in the independent 
overflow area. The EOF record would be shifted to the record 
9 location). | 


Two (These are the ‘end' entries for the overflow chains 
from tracks 00 and 01 on cylinder 160. They are located at 
records 01 and 08 respectively). 


C= 155 H= 00 R= 02 (This record (KEY= 00000197) was originally 
the last record (record 18) on track 02 of cylinder 160 
when the file was created. 


A completely filled-in map of the ISAM file is contained in Appendix A 
of this manual. It is suggested that you do not refer to this map 
until you have completed WORK PROJECT 13. 
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RD A EEE ED EEE ES NED TITEL GUNES GRE ED EEO ERD GP AES EE EES ED CE TED CRS TD 


Upon completion of this project, the student using the available 
documentation, should be able to: 


1. Determine the number of physical records in a Spanned Record File. 
2 Determine the number of logical records in a Spanned Record File. 
3. | Determine the length, in bytes, of a logical record in a Spanned 


Record File. 


Time required to complete this project averages 1.0 hour. 


ED CED Ee CTS AD EP ae ED OG ES AE TED 


DOS/VS Data Management Guide 
DOS/VS Supervicor and I/O Macros 
DOS/VS LIOCS Volume 2 


Directions to the Student 


This project consists of performing a reading assignment and then 
auswering questions relative to a printout of a spanned record file 
on disk. 


Spanned record capability allows a logical record to exist on disk 
as a part of a single physical record or as multiple physical records 
(refer to Figure 1). | 


Spanned records are format V (variable) records, each of which 
specifies its own length. Spanned record processing is an extension 
of variable-length record processing. This technique offers the 
advantage that a user need not be concerned with the restrictions 
hardware imposes on the length of physical records. Thus, a user 

is able to maximize secondary storage efficiency, while organizing 
data files with logical record lengths most suited to needs. DASD 
access methods allow a logical record, either blocked or unblocked, 
a span multiple physical records. 


Ve The user need only be concerned with logical records; 
I0ocS segments and blocks logical records while making 
a most efficient use of the track capacities on DASD 
devices. 


2. The user is allowed greater flexibility in transferring 
logical records from one type of DASD device to another, 
when making use of the DASD access methods. 
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Activity 
IN: DOS/VS Data Management Guide 
UNDER: Section 2: DOS/VS Data Management Facilities 
READ: "Variable - Length Records (Format V)'° 


'Spanned Records (Format V)! 
‘Control Information' 
Read the following: 


Major DTF and Logic Module (MOD) considerations for spanned record 
processing are: 


A. Sequential Disk Processing (SD) 
1. DTFSD 
ae WORKA = YES must be specified 
b. RECFORM = either SPNBLK or SPNUNB 
Ce RECSIZE = (r) must be specified 
On output the user must load the length of the 
logical record into the register specified. On 
input the module will load the length of the 
logical record retrieved. 
2 SDMODVI, SDMODVO and SDMODVU 
ae RECFORM = either SPNBLK or SPNUNB 


3. The first four letters of SDMOD names that support spanned 
record processing are IJGP or IJGQ. 


B. Direct Access Processing (DA) 
1. DTFDA 
ae KEYARG = (required if RECFORM=SPNUNB) 
b. RECFORM = SPNUNB only 
Ce RELTYPE = (required if RECFORM=SPNUNB) 
2.  DAMOD | 
Ae RECFORM=SPNUNB only 


3. The first four letters of DAMOD names that support spanned 
record processing are IJIS. 


C. Spanned Record processing is not supported by Indexed Sequential 
Access Methods (ISAM). | 
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BLOCK DESCRIPTOR WORD 


Refer to Figure 2. 


The first four bytes of every physical record in a spanned record 
file, whether it is blocked or unblocked, constitutes a Block 
Descriptor Word. This word describes the physical block which 
immediately follows it. The first two bytes contain the physical 
length (LL). This length is supplied by Data Management when the 
file is written. The last two bytes (RR) are reserved and set to 
binary zeros. The user is required to reserve, for use by IOCS, 
the four bytes occupied by the Block Descriptor Word, at the 
beginning of his input and output areas. 


A physical record may simultaneously contain complete logical 
records and/or segments of a logical record because the length of a 
logical record may exceed the size of a single physical record (or 
block) on the output device. 


Each complete logical record, or segment of a logical record, includes 
two bytes for a length field (11) and two bytes for a field used by 
the data management method (rr). These four bytes are called a 
Segment Descriptor Word (described below). 


The length of each logical record must be anette’ by the problem 
peCgnae at the time the record is to be written. 


SEGMENT DESCRIPTOR WORD 
Refer to Figures 2 and 3. 


When a logical record is written on a spanned record file, each 
complete logical record or segment of a logical record includes a 
Seqment Descriptor Word. The Segment Descriptor Word is a four- 
byte field which describes the data bytes which immediately follow 
it. The segment length (including the four bytes occupied by the 
Segment Descriptor Word itself) is contained in bits 1-15 of the 
first two bytes (11); this value must lie in the range of from 4 

to 32,763 inclusive. Bit 0 describes the segment type. If this bit 
is off, it indicates that the segment is a normal one; if it is on, 
it indicates a null segment (containing the 8 descriptor bytes only). 
The last two bytes of the Segment Descriptor Word are reserved and 
set to binary zeros, with the exception of bits 6 and 7 which contain 
a flag value. 


Figure 3 shows the significance of bits 6 and 7 in the flag. These 
bits specify the relative position of a segment with respect to 
other segments (i.e., whether it is a single segment or whether it 
is the first, the last, or an intermediate segment of a multisegment 
logical record). 


4u 4 


The first segment of a spanned record may begin at any point in 
the physical record on the associated device. 


When a sSpanned record is read, the segment lengths specified in 


each Segment Descriptor Word are added together to provide the 
problem program with the length of the complete lcgical record. 


Study Questions 
Use Figure 4 (2 parts) to answer the following questions. 


Figure 4 consists of a disk printout of a Spanned Record File. 


1. The number of user physical records in this file is _ 
om The number of logical records in this file is _ 
3% The decimal length of data in each logical record is ane eee 
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ELD CES ELE TELAD WEED CLERO ELE LLL ERED LT CD CELLET LD RIND BLED CRP LEG CLES EEE LILLIES SELES LED BIAS 


Le 5 (1 'zero' flag (00) and 4 ‘one’ flags (01). Note that the 
segment descriptor word may occur anywhere within a block. 


3 32, 120, 400, 60, 240 
Ae An explanation of how the length 32 was determined for the 
first record is as follows: 


Block 
Descriptor 


Segment 
Descriptor 


1. The block length is 80 bytes (50 hex). 

2. The segment length is 36 bytes (24 hex). 

3. The flag in bits 6 and 7 = 00 which indicates that the 
whole record is contained within the segment defined by 
this Segment Descriptor Word. 


Since the length (36 in 2 above) contains the 4 byte seqment descriptor 


word, 4 must be subtracted from it to determine the actual record 
length (36-4=32). 
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tbh 
tp ody fda 


| omnbta - pe zoeloridg yioM 
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-nwamm LOgical Record 1 


a 


Legend 
Cog = Logical Record 


i 

i 

| 
cnn pe nrmmnnmmmnne | OEY | mene cree nennemn ding 
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PHYSICAL RECORDS (Blocked) 


< 


; 
f Log? Log 3 
eae eee 


SAPP LE TRO ADAM BT IRN ia | 


-, cans 
acorn 2 


pare ee anemone ee 
sea eater ates tr aneaemannseseat 


L0G iCal Recon 6 ee eet 


Logical Record $e 


eras 


RON IRC AA ONION RONEN NA 


A 


| 
i 
a 


Logica: 
Record 5 


Sqft 


S[Ttd Ppioday poeuueds e jo oTtduexg 


Z eainbtd - tL zOeforg y10M 


Length of Physical Record (Block) (LL) 


Length of Segment (I!) Length of Segment (11) 


rifefafal fre fe Logical Record 1 (Complete Record) vf ifee Logical Record 2 (Segment Number 1) 


0 0 
0 1 
ee 
4 | 
BLOCK SEGMENT 
Descriptor Descriptor 
Bytes Bytes 


a 


SS a on 
0 


2 


3 


\ 


Logical Record 3 (Segment Number 1) 
0 
1 
ufufal alate fe] « Logical Record 3 (Segment Number 2) 
0 


fefapafi fife] e Logical Record 3 (Segment Number 3) afedede Logical Record 4 (Complete Record) 
0 


0 
2 0 


9n1 


€ eanbtqG - hE. zOeLOAgd yrOM 


SpiomM tojydtaosaq yuaeubas pue yoo Tg 


Seg eee 


‘Block Eee Word 


Block length including 
itself. 


0 Off = Normal Segment 
1 On = Null Segment 


sedeadiniuetindine tices is uciadseummetancensiies Descriptor Word 


TT / length including 
itself. 


Reserved 


Reserved 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
} 
| 
| 


- Not followed or preceded by another 


segment of the same record 

- First segment of a multi-segment record 
- Last segment of a multi-segment record 
- Part of a multi-segment record neither 
the first or the last 
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SP ED PF ED PD De TD PEP EF ED OD EP EB BS FD ED ED DR FD OF EE BD OD DE EP OF 08 OE 0 EP A OD > OF DE SE OSE BH EO OOOO ODES 


CYLINDER 001. TRACK 00. HOME ADORESS= 00 000! 0000. CONDITION= OPERATIVE. USE= PRIMARY. 


LD BO 0 8. 0 0 0 BB BEF OB 0 8 8 BE OF 8 DE EE 8 OE EE BEM OE OO OSS SO BOON BOBO OMNES @ew 


RECORD 000. COUNT LENGTH= 8. OATA LENGTHe 0008. t 


COUNT 
00000000 
01000008 
DATA 
00000020 
01000E90 


RECORD 001. COUNT LENGTH= 8. DATA LENGTH= 00860. 


COUNT ¢ 
00000005 
01001000 
DATA t Pisa Ke cehecwesdeDerecwanee wees pene seseeewuueeksesese b0eCeeeseecees 


. 0500020055 5955555 55955 555955555595555555550200555555555555555555555555555555555955 
OOOOONOOCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCOB IOCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCe 


RECORD 002. COUNT LENGTH® 8. DATA LENGTH= 0080. 


COUNT + 
00000005 
01002000 
DATA ¢ ) FRHHHHHOHHHHHOHHOHECEHOEHHEEHREHAHEHEHEHHAHESEHEHEHHHOKSEAHHOHHHENEHEREEOOS 


050008 005555 59955999 59999999 5 9 00 99 0 5 9959 999 5999 0 905 995 59999 55 9595999595 55555555555 
O0000C SO0CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCcCccccccccccceccccccecccce 


RECORD 003. COUNT LENGTH] 6. OQOATA LENGTHe 0080. 


COUNT + 
00000005 
01003000 
DATA ¢ 2800 CCORCERe ReREG Es Kenekeus bebe he cea Senne Cass Neaeeeeebesterteusene 


05000 1005555555555550 3009959995999 99 99955 999959 999995995955555555555555555555555555 
QO000020CCCCCCCCCCCCOC 1OCCCCCCCCCCCCCCCCCccccccccecccccccccccccecccecccececccccccccce 


RECORD 00%. COUNT LENGIH= 8. DATA LENGTH= 0080. 


COUNT + 
00000005 
03004000 
DATA + TOSI IIIT TIITITIT IIT IIT TTI ITILI ITI TTI TI TTT TTI Tri ri itiiiiiritt iit t tt 


0500046 00555555555555555555555555555555555555555555555555555555555555555555555555 
QOOOOC SOCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCccccceccceccccccccecccecececccecccccce 


RECORD 005. COUNT LENGTH= 8. OATA LENGTH= 0080. 


COUNT _  ¢ 
00000005 
01005000 
OATA + ) POET YTYTTLTTITTTTTITTTTTTI TTT TTT TTT TTT TTT TTTTrrrrrererrerrrrrrrer rrr 


05000 8005955959999 5 999599555 65555 5 99 9595559955 5 5 555555 9555559999 9555 9595555555555 
OOO00C 3OCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCcCcccccccccccccccecccccccceccce 


RECORD 006. COUNT LENGTH® 8. DATA LENGTH= 0080. 


COUNT ; ¢ 
00000005 
01006000 
DATA ¢ } PHOMAHOHEHOHHHHEHROHSHOHAHEHHHFOEESEHHOEHPORHOHOHHHH EEE SHSHEREHOCHOCEEEHOERODE 


05 000000599595 5599955 9 5 959955 5 55 5 95999999595 959555 55 9 58 9999955599959 5959555555555 
OO0000C SOCCCECCCCCCCCCCCCCCCCCCCCCCCCCCCCCCccCccccecccccccccccccccecccccccccccecccc 


RECORD 007. COUNT LENGTH= 8. DATA LENGTH= 0080. 


COUNT . + 
00000005 
-01007000 
CATA ¢ ) SHHSHSHHSHEHOHHSSHHOHGEEHRHOKHSHOHHHKHEHHEHHOFHOCHSCHHHHHEHEKHOROSECEHOOEHECEREHRERECEE 


09 00000055 9595995559 995950 95 5555095 0 5 999559990 09555 99995 99999999999 5959555555 
QQ000C SOCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCcccccecccccccccc 


RECORD 008. COUNT LENGTH= 8. DATA LENGTH= 0080. 


COUNT * 
00000005 
01008000 
DATA ¢ SHSHSCHHHHECHSEHHHEHHEEHHHHECHHEOHEDOFOLEEORODOHESHEHERELE eeeeenensenen 


05000 30055 95 5999 5 55 5 99 595 9559955 99 5 5 9995 5999 99 9 99955 999595999555550 100555555555555 
OOO00C 20CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCccccoolocccccccccccce 


Work Project 14 - Figure 4 Disk Print of Spanned Record File (Part 1 of 2) 
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RECORD 609. 


CQUNT 


DATA 


RECORD 010. 


COUNT 


BATA 


RECORD O84, 


COUNT 


Oats 


RECORG Oe. 


COUNT 


DATA 


RETORD O14. 


COUNT 


DATA 


RECORD Cle. 


COUNT 


Work Project 14 


COUNT LENGTH* @, OATA LENGTHe (060. 


+ 
00000055 
91009009 


ry PT eTVIPTIT ITIL ETT eee eee ers CERHHHTOSOROH EHO ERAD 
05000 30035 959.55 99599: 5 5995 95 555 55 55 959595 9995595955595 6599595950 $905555599554555555555555 


8 
CO000e ZUCE LC LOCOOC LEC COC OOE COOOL CLO CCL eee cece eee eer Oe SUC COC CE CEC CC CCC cece ce’ 


COUNT LENGTH* 8. Data CoMGtike O0aG., 


¢ 
00000065 
01004000 


+ } REESE HESH AER EORAR ED ROHTEAV AP OP RAAEEEEAREEERHR SETAE FAREED SOSHR ET OT DHE EH DE 
0500080055 959555 5 5595 58 8 99 9 8 8 8 59 595 55 895895 555595595555555 
OOOOOE SOCK OLL COC COCO CCE COC LE CEC CK CeCe ence COC Ce Cr Cee ec ere cc ee ccc cers ec ce cece ce’ 


CGUNT LENGIN® 8, Ala LENGTH= DG80. 


$ 
60900005 
01008000 


* bo PR MOHMA EH EH TOMER A EERE ONES HEE E HEHEHE HEHAAOHREOUROHHEOMHETAGE OE GOH REET ER EE 
0500040095 $5955555555955595995-55 55959555555 9955555 5559555 5595595595 55955 595555555555 
COOK 4OCC COCCCC Cece ce Cle COE CUE Cee Ce Cee OE CeCe Oe CC CCCI CC eee ee COC Cee eee 


Rams Mee 


COUNTY LENGTH 8, OGATA LENGTies D080. 


* 
00000005 
o1og0cans 


+ fo PM ORHEH TERE HTEHKER EOE BEET HEREHERORH EO RTADHEEBAOHTATHH EOC EHTHGOHRERES HED EE 
05000000455 9595 6 5 6 69 5 605 0 0 0 5 9 6 OS 8 8 08 5 5 8 0 6 00 8 ooo on S88 eo 95 999 95 99585 55555555555555 
NOd00C SOCCCCCCCCHCOCCCCCOCCRC COCO CC CC COCO CCL eC CC CC Cee ce cee ccc cece cece ccs 


COUNT LENGTHs 8. DATS LCENGTHe O02. 


LOLOL CLes CLO LSLG) 
O1ggpoGcec 


#8 ee 
6600000645555 
Ocodds2OCCCE 


COUNT LENGTH* 6. DATA LENGTH HO00. 


00000000 
O1QO0EOOD 


-~ Figure 4 Disk Print of Spanned Record File (Part 2 of 2) 


Cylinder 
Overflow 
Track 


| 


155 
9 10 11 12 13 14 15 16 17 18 


PRIME DATACYLINDER 
1 


INDEPENDENT OVERFLOW CYLINDER 
8 


7 


Added Record (after file was originally created) 
6 


8 
Cylinder Overflow Control Record 


Track Index (normal entry) 
Track Index (overflow entry) 


4 5 


4 
: 
COCR 
TIN 
TIO 


LEGEND: 
3 


2 


1 


Bx 
— 
wy 
fx 
5 
~ 
om 
t= 
a 
eel 
E 
or) 
ond 
E 
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EB 
for) 
et 
E 
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eon Twa oom 


Map of the Records Contained in the ISAM File for Work Project 13 


449 


SELF-EVALUATION QUESTION ANSWERS 


CONCEPTS OF A_ PROGRAMMING SYSTEM 


1. ae 
b. 


Ud 
r) 
pa) 
e 
We SENOWNUA Oe SWWerD VB EWAWANWAN'N 
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DOS/VS_CONCEPTS 


1. b 
2 e 
3. ae 1 
ce _5,9 
d. 2” 
7 Pee EEE 
f- 10 
g- 4 
he _ 
i. 8 
j- 7 
ke 3 
1 
Mme _ 6 
4. d 
5. a 
6. linkage editor map 
Te stand-alone 
8. False -- The standalone dump destroys the DOS/VS Supervisor 
9. a 
10. a- All other answers would have resulted in an error 
message. 


1. a 

2a a 

3. a 

4. d -- The Q identifies POWER 

oe e -- F1 partition 

6. b 

Te d -- Table EF3 in the SADP manual 
8. Re-IPL 
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DCS/VS_PROCEDURE_ LIBRARY 
Vs a,cC,e@,f,9,h,1 ~~ Although ASSGN and TLBL statements can be 
. included, they are not required unless the 
specific procedure calls for it. 


2s b 

33 False -- Refer to "SYSIPT Detail Catalog Procedures 
(GC 33-5371) 

4. Cc 

Ds True 

6. d -- must contain $$ to operate in any partition 


te True -- When FOP parameter is omitted, /+ is the default 
EOP parameter. 
8. b 


POWER OPERATING PROCEDURES 


TED CREED EG ED SEE AAD eine 


1. b. Job ‘A; has a Hold parameter on it. 

2 b. No partition parameter defaults to BG. 
3% b. 

4. ae 

De: * Gx 

6. Ce 
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Cylinder Cylinder One Cylinder 199 


= 
2) 
pa] 
on 
= 
x 


[FE 121549) 


Core Image 

True 

Source 

Relocatable 

ae There is always a Core Image library on SYSRES to 
contain the Supervisor, IPL, etc. 


// DLBL IISYS01,'DOS. WORKFILE. NO. 1',99/365,SD 
// EXTENT SYSO001, 111111,8,1,20,550,9 

// DUBL IJSYSO2, 'DOS. WORKFILE. NO. 2',99/365,SD 
// EXTENT SYSO002,111111,8,1,30,550,19 

// DLBL IJSYS003,'DOS, WORKFILE. NO.3',99/365,SD 
// EXTENT SYSOO03, 111111,1,1,1120, 260 


SERED AESSY eeepc STEED waa EP 
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PHYSICAL INPUT/OUTPUT CONTROL SYSTEM (PIOCS) 


Ce (Braces indicates a required parameter) 

e. (No option of the required parameter is underlined, 
therefore none is assumed - one must be selected.) 

ae (The command-list-name is the second operand ina 


CCB macro). 
cs (Byte 2 - bit 0 of the CCB). 


e. (CCB is for SYSRES - Byte 6 is X'00" which indicates a 
system logical unit of which byte 7 identifies 
SYSRES) . 

PDUMP READ, READ+23 (24 bytes in a CCB when fourth parameter 

used.) 

False. (Problem program issues an EOJ macro which loads JOB 

CONTROL from core image library.) 


Ce (Problem program option bits 3 and 5 in operand 3 of 
the CCB.) 
ae (Byte 3 - bit 6 turns on when channel 9 in carriage 


tape is sensed.) 
X'2800" (bytes 9-11 in CCB); X'2818 (bytes 13-15 in CCB 
minus 8). | 
Ae (bits 3, 4, 5, 6 and 7 are user option bits and are not 
reset by the supervisor). 
ail; b1& 4; c13 d2; e33; £13; g5 
False. (They will contain the CCW for returning sense 
information to the problem program). 
False. (They are always changed by the macro, but first 
they will be saved in the designated ‘savearea'). 
abc. (All three dumps will provide this information). 


a=33. D-5% -C=6;5-d=2; e-4;. £-8:. ge 11s. he 7s: 2-123. 53-13 


d and £ - Bytes 9-11 of CCB (in a dump) point to start of 
CCW chain. 

d. 

False (Job is automatically cancelled) 
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LINKAGE EDITOR CONTROL STATEMENTS 


1. 


PC - this is an unnamed START. Providing a name would make 
this a section definition (SD). 

SD - this, like naming a START, is the name of a control 
section. 

a block of coding that can be relocated, independently of 

other coding, at load time without altering or impairing 

the operating logic of the progran. 

linkage editor 

EXTRN or V-type address constant. If the EXTRN is used, 

the name appearing as the external reference appears in an 

A-type adcon in your control section. ER stands for external 

reference. The symbolic name associated with the ER is not 

defined in your control sections. 


Ae Define an entry point in the linkage editor entry 
statement. 

b. Define an entry Borne in the end card of the first 
phase. 


Ci By default, it is the first byte of the first phase 
if neither of the first two options are used. 

Use the entry name parameter in the fetch macro. 

Use the // OPTION CATAL job control command. 

payroll, the first doubleword following the SUPERS TE Oh 

CSECT1 and CSECT3, mainline, all PTIME. 

+ displacement, F + address, NORFL 


@O 
e 
MOO od ~J Ww UIN & a= 


Phase _ Name Core Location Entry Point Disk Address 
PHASEO1 20500 20500 Cyl 30, Hd 7, Rec 
PHASEO2 20880 — 20880 Cyl 30, Hd 8, Rec 
The assembler requires units SYSIPT, SYSLOG, SYSLST, SYSRDR, 
SYSLNK (for output), SYS001, SYSO02, SYS003. SYS001, 002, and 
003 are work files. Linkage editcr requires SYSLNK and SYS001. 
Error has occurred during linkedit edit. You will find the 


actual error message on SYSLST linkedit map. 
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2 
1 


VIRTUAL STORAGE CONCEPTS 

13 b. Real addresses -- prior to EOJ during IPL, DOS/VS 
executes as a single partition real systen. 

Le False These entries will contain the storage protect key 
of the partition and they will be marked as 
invalid address space -- high order bit will be ON. 

3% False They are TFIXed. 

4. False Some pages already read-in may have been paged out 
to make room for a program that exceeds the available 
real storage. 

Se False The first PT entry for the partition contains the 
real address for the frame containing the 
partition savearea. 

6. b. FETCH contains its own CCW Translation routines and 
does not require ‘Cory Blocks'. 

Ts False 

8. True 7 

9. True Real storage above area specified by SIZE remains 
in the selection pool. 

10. bd. The area above SIZE minus 2K. 

11. False Bit 15 is turned ON in the PT entries for all pages 
in the partition which in effect erases any pages 
on SYSVIS by indicating that no copy of the pages 
exists on SYSVIS -- they are not actually erased, 
however. | 

12. False PFIX is a virtual program function. 

13. True Outstanding TFIXed frames must be TFREEd before 
the GETREAL function can be accomplished. 

14. = d. 

15. (a) 3 

(b) 4 
(c) 1 
(d) 2 
VIRTUAL STORAGE MACROS 
Ts 2-- The list is terminated by the non-zero X'01' in the 
second 'DC'. A range of 2304 addresses is 
specified therefore two page frames will be fixed. 

2% is not -- PFIX byte must be equal to zero (0); no pages 
PFIXed in page frame. 

3% False -- The return codes will be returned in Reg. 1. 

4., X¥'088800" -- BGV partition beginning (512K=X'080000!) plus 

SIZE area (32K=X'008000') plus 1K (X'000400°) 
plus 30 bytes (X'OOQOO1TE'). 

De False -- at the address contained in Reg. 1. 

6. True | 

Ts False -- All page faults in the system are resolved by the 

PMGR; the USER PFA routine only determines when and 
in what sequence they are to be handled. 

8. False -- The CCB, Channel Program CCWs, and the I/O areas 


associated with the EXCP, REAL must be PFIXed, 
the EXCP,REAL itself. 


not 
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9. False -- It will contain zero (0). The virtual address will 
be returned ONLY if the page contained in the frame 
is fixed. Because the frame is in the selection 
pool, it is NOT TFIXED or PFIXed. 


1. False -- PDIADS reside in the Supervisor PD area. SDAIDs 
reduce the page pool. 
2 can -~- They must first be output to the tape and then listed 
via PDLIST. The cannot be directly output to a line 


printer. 
a6 SYSO005 -- Same symbolic unit used when PDAID output is 
written on tape. 
4. False -- It will be located in Event Handling Routine Area. 


The PD Buffer Area will be used as a rotating buffer 
to store the trace entries. 
ae PDARPTR; System Communication Region. 


6. 40; 56 -- Refer to Appendix A in SADP (GC33-5380) 

7. PDAIDTDT -~ Refer to PDAID Chart 01 in DOS/SVS a a 
Serviceability Aids (SY33- 8554). 

8. 12-13; PD Standard Preface -- Appendix A in SADP 

9. 0-3; PD Address -- Appendix A in SADP 


10. Dump: XXXXXX,XXXXXX 

11. 20-23; 24-27; PD Standard Preface 

12. False -- This would be true only if one or the other of 
, these aids were uSing the alternate area. 

13. True 


14. False -- Only the PGNCHK event will be traced (by default). 

15.2 90004444 

16. False -- PGMCHK - only event selected when all events 
defaulted provides complete supervisor output 
which includes these tables. 

17. False -- A PDUMP can be obtained without STOP ON EVENT 

18. SDEHR 

19. False -- can also be terminated by AR routine 

20. True 

21. SYS000; SYS001; SYSLST 

22. False -- The SA trace function of SDAIDS is not active 


during I/O channel operations (i.e, during loading 
or fetching). 


Ve d 

Le a 

= True 

ue e (Must be // EXEC IJZADOLT, REAL) 
De e (AK) 
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1. d (CE should notify dispatch to call a PSR). 
2 e (PROGCK should be used for DOS/VS - not ABENDXXX. Refer 
to PSGI Handbook —- PSM 16.) 

Se PINS74U5-BB-PTF/O60174/END (Refer to "FORMATS FOR REQUESTING 
ITEMS IN THE PIN PROGRAM OF RETAIN'® 
in PSM 12 and ‘How to Use the BB~PTF 
Section of the DOS Symptom Index’ 
in PSM 13 of the PSGI Handbook). 

4a. PIN574U5-RL-290/ALL (Bucket SRAID-039, now on EWS 

microfiche, announced two new RETAIN/360 
buckets for DOS/VS Release 29 
information. Bucket AR-290 contains 
DOS/VS Release 29 PTF information and 
bucket RL-290 contains DOS/VS Release 

29 SYSGEN planning information.) | 


Ne Re ee ee re ne ee ee 


1. a. Pre-installation planning 
b. Installing the SCP 
c. Verification of the SCP 
d. Customer Education 
2. Program Status Document 
36 decide on the number of system packs 
(Figure 1-1 in the SYSGEN SRL) 
4. PSAL (Programming Systems Activity Log) 


PID SYSTEM 
1. Cylinder 695 

2e conflicting job specification 
3. // FILEST SYSIPT,1 

4. RT PDK 
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ES ERD APRS AP AE A TS A A 


a. Cylinder 0, Head 1 (track), record 5 

d,e SYSRES and SYSUSE 

b. P5 would then have the entry for X'021* built in it. 

ae Only LUB entries that point to a PUB that is moved are 
affected. 

ae Same as for question 4 

b. Six (6) | 

e. S$IPLRT4Y would process a SET statement. 

False INITDAT 

d. IPL ($S$ASIPL2) 

180 Nine full cylinders, even though only 171 tracks are 


needed. 
False DPD must be issued, even if no operands are 
specified. 
False Only if it was called by a DPD command; not when 
called by a CAT command. 
True $$AS$IPL2 does this also. 


DOS/VS_LIBRARIAN PROGRAMS 


DSPLY RD or DSPLYS RD 
have the private SSL assigned 


False The MAINT programs supply the catalog function. 


CORGZ 
LNKEDT 


ES EE CO A ED TS A ND CED ATS EE ED OE 


Set address of PPBEG to next 2K boundary. 

CVCGEN One set of parameters for each I/O device. 

DASDFP = (1,3) No disk type is required due to default 

| values. 

False This SYSGEN macro must appear in the deck. If 
the default values are correct for STDJC the 
parameters may be omitted. 

the 115 and 125 

SUPVR macro RMS, CHAN and MCH parameters. 

False Under the Supervisor/Generation macros in SYSGEN 

manual, see Rules for Using Supervisor Generation 
Macros. 

SYSLNK, SYS001, SYS002, SYS003 

The RSIZE parameter is greater than 96K. PID system 

specifies RSIZE=96K. 
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INSTALLATION VERIFICATION PROCEDURES (IVP) 


1. 
2 


DELUNSD 
14K 


JOB CONTROL 


REED MELE CISD 


ILD LL EE CELLS SD 


e. SJOBCTLD does the actual processing of an ASSGN 


statement -- not $JOBCTLA. 


ae F (ALLOCR) 

b. T | 

c. F 64 bytes from origin address 

d. F Unconditional SYSLOG and conditional SYSLST logging. 

ee. T 

£5: -T 

False 748 bytes -- only one TXTRCD is indicated and it is 
therefore also the last TXTRCD. 


False The eighth byte in $JOBCTLA will indicate the name of 


the phase in the overlay area. 


False (DOS/VS Release 29 and later automatically support 


generic assignment.) 
(address-1list) 


POWER GENERATION 


Record and monitor POWER events for PSR debugging purposes. 
INIT. An entry statement with this operand is required when 
linkediting POWER. 

1,350 

MINISIZE 

FGPSPOOL 

ae FGP.ALL 

b. $$BPOWR1 

c. I1027X0 

d. 102540 


UTILITY PROGRAMS 


CLRDK 

SYS000 

immediately before 22220001 card. 

False. The end of data requires /* EOD card followed by /6&. 
LVTOC 
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SUPERVISOR INTRODUCTION 


CTD: CARE EALE LIRED) OUR UTE 


a Foreground 2 or F2 
2s x'8s0' 
Se IODEV= 
4. 3330 
Ds True 
6. X*EC' or 236 
he Byte 57, bit 3 of COMREG 
TASK SELECTION 
1. False 
20 Off 
36 TRTFLD 
u. SVRETURN PIBDATFL would be x'01* and the routine 
DATEXIT would branch to SVRETURN. 
Sy svc 33 
6. Bytes 4-7 of the PIB Extension 
7. Byte 1 of PIB | 
8. LPSW from save area (savearea address in PIB) 
9. In F1 PIB bytes 5-7 
10. Bytes O and 1 in PIB extension 
11. Indicates that the associated resource is not available for 
use. : 
12. X*2E* or 46 dec., X'10' or 16 dec. NOTE that F3 has a SP 
key equal to 3 and PIK is X'30°*. 
13. LTA is in use by a F2 (PIK=X'20*) progran 
14, In the partition "COMREG! bytes X'6E* and '6F" or 110 and 
111 dec. | 
CHANNEL SCHEDULER AND I/O INTERRUPT ROUTINES 
Ts Cc 
2a, Oa 
3% d 
q. ae 02 
b. 83 
c. 50 
d. is 
e. is 
f. false 
g. is 
h. 9 trk tape 
5. LISTIO UNITS LISTIO ALL would be incorrect because it 
does not show units in PUB table that are 
unassigned or down. See DOS/SVS System 
Control Statements LISTIO. | 
6. Channel Bucket 
7. F3 
8. 


Ignore Note that if a device is assigned to ignore, no 
| errors will.occur when doing I/O on device. 
No I/O will occur. | 
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ERROR RECOVERY PROCEDURES 


1. Bytes 8-9 give the displacement into the PUB table. See the 
DOS/VS Error Recovery and Recording Transients PLM (Figure 3) 
2a $$ABERRY (Figure 2 in the PLM) 
36 ae X'QOE® 3 
b. BG 
Ce OB 
d. Unit Check 
e. X*O22AD8' 
f. X*'O022B48! In some cases the CSW command address is 
updated by 8. In other cases, it is not. 
Refer to Channel Status Word Command Address 
in the Principles of Operation manual. 
ge X*QOtT® Channel 9 Overflow (carriage tape). Refer 
to the figure in the PLM that shows 'Sense 
Information for Devices Supported by Device 
Error Recovery’. 
h. 1 (Background issued the message) 
4. $$ABERAA (See SUPERVISOR PLM CHART 07) 
ore Displacement of X'00" in SYSCOM contains a two-byte pointer 
to a channel scheduler error block. The two bytes preceding 
this error block contain the address of the error queue (or 
add x*10' to the address in SYSCOM. 
6. Flow Charts in DOS/VS SADP manual or in APPENDIX B of this manual. 
Ve SSABERRS (Refer to Appendix B in the Error Recovery PLM). 
8.  X*4Ua" or 74 -- Figure 33 
9. xX*'41" or 65 -- Figure 33 and Figure 48 
10. Store statistical data for the RMSR routines. 


SELLS EID SESSA LLL ALES LL SIRE LLY LES SLY AED I LIS LS ELD CERI ID SERED FLED TY LED ER AL EID EELS ES SD 


1 


There are no self-evaluation questions for this topic. 
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GS AED AED ST AO LES EIOAIED SER IEED 


Ae b 

Ze F/L TRACE 

3. d 

q. a 

5 Cc 

6. b 

Wm d 

8. ae 3 
b. 1 
c. 4 
d. 2 


SUPERVISOR (FETCH) TASK OPERATION 


NAT A ERG TEE TE ASE OE ISAS: LLDCS OL ATER AEE 


There are no self-evaluation questions for. this topic. 


nD TEP Sa GREP aise Gal DE GEM EE? GED SED Crab ED 


1. True 
2< a. Saves disk search on FETCH 
b. Only one copy of an SVA phase in real storage 
c. SVA phases do not have to be loaded from disk 
3. a. LDL 
b. PCIL/LD 
ce. PSLD 
ad. SDL 
e. SLD 
QW. ae SET SDL=CREATE 
b. JACK,SVA 
Ce. /* 
Ss PHASE JACK,*,SVA 


DOS/VS_TINERS 


1. Terminate the linkage to a user's routine 


2s False -- Maximum is 15 hours, 31 minutes, 58 seconds 
is not | 

u. WAIT and TECB Macros 

Se 30 minutes 

6. TOD clock 

Te zeros instead of valid TOD 
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©} PAGE MANAGER CONCEPTS AND TABLES 
1. b -- See DOS/VS Supervisor Logic - Page Table 
2s d , 
36 True -- Used by DAT hardware for address translation 
4. a 


ETE ERLE ELITE LEED EEO IED ERED LL STS STE REIS EIS SENET IY REIT PE SE 


1. x*8001'° 

Ze svc 33 

Bs Svc 59 

4. the Supervisor 
5 0055 

6. FFFF 


PAGE MANAGER SERVICES 

te 90 (Hex) or 144 (Dec) 

oe Byte 3 (=Select) 

3m the page is not in the selection fool 


4. False 
Se if a page fault has occurred at a valid point in the 
Supervisor. 
6.0 Byte 0, bits 4-7 (WID) 
© Ve PFIX, page frame 


PAGE REPLACEMENT ALGORITHM 

1. the least recently used page. 

2 Queue switch 

36 False. Only a pointer relative to PFT begin. 

4. No entries in this queue. 

Die Reset Reference Bit 

6. ACONST = Maximum number of page-ins per second and 
BCONST = Maximum re-entry rate. 

Vs 8001 

8. True 


PAGE MANAGER OPTIMIZATION 


ES ED EEE EATS ID ES OD PED CED SLD A RD SEES ND CREED CEE CLEP SCD 


1. False. The FCEPGOUT macro merely promotes the page frames 
_ to the head of the replacement queues. The affected page 
frames may still be in real storade. : 


Lis REAL parameter is ignored. 

35 The page table (PAGETAB) is full, this request was ignored. 

4, discontinue processing this page and set a return code of 
xX'O8*. 
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SP EERO SE CEE TREPRES) CHD EEN CED SD AED 


True 

a dynamic work and save area. 

72 (Decimal). All copy blocks are 72 bytes. 
FIX BLOCK 


D> GERD GEREN aS AOA ES GAEL EA ALD AES CET CE 


63 (X"'3F*) 

False - The request for exclusive use of the resource must 
wait until the resource is no longer shared. 

False 

5 | 

SYSVTOC 

$JOBCTLN , 

byte 75, JA Interface Partition Table 

c. interval timer 

13 


FOPT | 

The range of channels to be protected by DASD File 
Protection. 

DASDFP = (1,1) - 2311 and 2314 are defaults. 

Supervisor (Channel Scheduler Routine). 

No (Only the user's seek field is used. The address of this 
field is inserted in the data address field of the seek CCW 
that is generated for DASDFP). 

JIB (Job Information Block). 

LUB (Logical Unit Block - byte 01). 

FOPT 

SKSEP 

The 'nt parameter can be used to generate additional SAB 
entries for future expansion. This parameter must be 

equal to or greater than the number of DASD devices specified 
in DVCGEN macros at system generation time. 

SAB (Seek Address Block) 


x'38¢ 

ae CCW command code not a long seek (X'07*) 

b. CCW seek address same as seek address contained in 
SAB entry. 

Cs New seek field not in real storage. 


d. Seek is not chained. 
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ee § # 93 


DANIAN SEWN 


c,d cs 
a-c,dwv 

b- a,b,c,a’ 

c- c,d 

d - c,d 

/*, B , Tape Mark, last line printed, 
end-of-file, record (data count=0) 

GC, tf, he 2 

Index Sequential 

Sequential, random, index sequential 

5 


STEED ELEM ALM LS TP LEGGE RD EEDY AOEED AED PS PSTD EF ER OES A eee 


1287 or 1288 (Reference Sup and I/O Macros SRL - DTFOR) 


False - This is the programmer's responsibility 
Aig: Ce 
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MAGNETIC TAPE FILES/MACROS 


1. 


2. 
3. 


When the last record in the I/O area has been passed to 
the problem progran. 

No. If WORKA=YES, omit IOREG= 

Yes. ERROPT=ERRUT will cause LIOCS to branch to the 
label ERRUT in the problem program to process errors. 

4 - The physical record is 320 bytes in length and 

each logical record is 80 bytes long. 


__b—- TRUNC 
__f RELSE 
__e VARBLD 
__a IOREG 
__da__ IOAREA1 
__¢____-WORKA 
LJFFZZWZ 


80 

SEPASMB=YES 

Chart DD (LIOCS - Vol 2) 

72-75 

80-83 

c - With blocked records, a work area or a register 
must be used 

b 


PERE AED AES RT EE LY EIS LED ETP LIRR TD AEE SLE ELD ATID EELS LED SEELEY 


10. 


a, i, 4, b (//JOB, //OPTION PARSTD, TLBL, /&) 
d, b, e ~- Block count is a field in all file labels, but 
is only valid ina trailer label. 
EOF, EOV 

- Volume 

- Standard Header 

- User Header 

- Standard Trailer 

- User Trailer 

DITTO or the Tape Print Utility 
a - January 23, 1970 

- 7 | 

- EOF (trailer label) 

111111 

December 31, 1970 

1 (Field 6 determines this) 


0fm@AQAw®m 


homan o& 
t 
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11. 
12. 


13. 


|W 


Yes 

Volume Label - written with initialize tape program 

TM 

Data record 

a- 2, 3, 4 

b- 1, 3 

c- 1, 3 - checked on output only the first time the volume 
is written 

d - 3, _ 7, 8 


¥) 
e- 5, ar, 
£7 Se Pa ra iv | | 

. jy. Ge Cy a d, h, ay NN, b, My eC, Pe Nh, Ky , nN, 1 


(b and n occur at the same time) 

True 

This macro must be issued by the problen programmer to return 
back to LIOCS after processing user labels. | 
Branch to user routine. (LIOCS will not read, write, or process 
non-standard labels). They are the user's responsibility. 


EQUENTIAL DISK FILES/MACROS 


Anytime on output files - following a GET on input files 
60, 61, 62, 63, 64 

22-28 

248 —- must include 8 bytes to build a count field 


IJGFOZZZ 


ITJGCUCTC 

False 

ERROPT= 

ERREXT 

False 

b, e 

a 

a ~- address of the DTF that failed 


b - address of the error block 
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1 e 
26 
3. 


6. 


LEED ELL LELD ERED ELS CELE LTS DEEDS LIS LETS OED LED LID ITS 


(Reference DASD Label SRL) 


6 
nun Or Ut ~) & WW =a OV N) © «a ~] ~) WW WZ 


n the first track of the first extent 


rh ENUM WH DOU rQMhoandowe® honda ioA 


10 - one extent gives 1 track and the other gives 9 more. 
Hex 3C, decimal 60 of the partition COMREG 

// JOB | | 

// ASSGN SYSOO4,xX'cCuUUt (Disk Address) 

// ASSGN SYS005,X'CUU' (Printer Address) 

// EXEC LVTOC 

/& 

Field 5 of the (first) volume label 

22 to 28 | 

Format 1 file label. If more than three extents are required, 
additional extents are defined with format 3 file labels. 


a : 
// EXTENT SYSO001, 222222,8,1,0010,0060, 2 


// EXTENT SYS002, 222222,8,1,0013,0060,5 
J// EXTENT SYS003,222222,8,1,0016,0080 
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11. 


13. 


14. 


15. 
16. 


ED GERD CHEATED EES BI EPEC ES SED LLG CD TIS 


True 

An automatic seek overlap on all read, write and control 
requests 

Each time a read/write is issued by the problem program 
By interrogating the test byte (macro switch) 

- 4 

- 1 

- 3 

- 44-45 

- 41-43 

- 64-71 

~ 48-63 

- 96-143 

ID of last record, the number of unused bytes 
*"A7189A881014! 

a- 1 

b- 2, 3 | 

No room found while processing the WRITE AFTER macro 

To write an EOF record - now the data can be read 
sequentially from the file 

To generate a seek address for a given data record 

Clear disk - this utility formats the disk pack into fixed 
- length blocks that contain the count, key and data areas 


omawrrMAnaD 


a- 3 
b= 2 
c =~ 6 
d- 4 
e-7- 5 
f - 1 
no 


It should be 8 bytes long (mbbcchhr) and the bin reference bytes 


should be 0000 for a 2314. 
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DIRECT ACCESS FILE LABELS _ @ 


Vs When the programmer wants to process label extent information 

Ze The symbolic units used in the extents must be contiguous 
(SYSOO0O4, SY¥SO005, SYS006, etc) 

3 True 

We 3400 is the relative track (cylinder 170, track 0) and the 
100 is the number of tracks to be used for that extent 

5. No - Split cylinder is not used in DA Files 

6. The extent information for the job being processed overlaps 
the SYSRES file | 

Ta Display the VTOC and CANCEL the job . 

8.. The extent information passed to the problem program at. 
XTNTXIT time determines the upper and lower limits of the 
extent to be formatted on the disk. 

9. BYTE - 0 1 2 3 4 5 6 7 8 9 10 11 12 13 
VALUE 01 01 OO AA OO 00 O00 AE OO 19 01 04 00 00 
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6. 


To 


a- 2 
b- 1 
c- 5 
d- 3 
e- 4 
f - 7 
g - 6 


KEY = 120, DATA = Track 1 Address 

The highest key ever associated with track one is 150 

This is a pointer to the overflow area so the record with a 
key of 150 can be found. After creation of this file, records 
were added and the record with the key of 150 was forced into 
the cylinder overflow. 

a - No change to master index 

b —- No change to cylinder index 

c - Track index - record 5 key area will be changed to 235 
and record 6 data area will be changed to track 8 record 6 

d - Track 1 no change 

e - Track 2 record with key of 235 will displace record with 
key of 240 

f - Track 8 record with key of 240 will be added as record 6 
and a sequence link field will be created 

g ~ COCR record will indicate that track 8 record 6 is the 
last record written in the cylinder overflow area 

Master, cylinder, and track indexes will all have to be 
updated to indicate the highest key in the file. 

a - All records must be fixed length 

b - All keys must be physically located in the same place 

in each record | 

c - There may be no records with duplicate keys 

d ~- All records to be loaded must be in sequence by key 

The extend function consists of adding records to an existing 
IS file and all records are used to extend the file must be 
higher than the highest key presently in the file. 

The EOF record becomes the first record on a prime data track 
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INDEX SEQUENTIAL IMPLEMENTATION 


11. 


a ~- INDAREA= 

b - INDSKIP= 

c ~ INDSIZE= 

False - CORINDX parameter in the ISMOD allows for the cylinder 
index in virtual storage 

X*02* Refer to LIOCS —- Volume 2 DTFIS Load Table 

ISFILE is never opened and there can be no WAITF after a 
sequential WRITE 


a, a 
a~- 2 
b- 1 
c - 6 
ad - 3 
e- 1 


SETL, ISFILE, BOF 

117-124 (DASD Labels ~- Format 2 label contents) 
92-93, 1, OPEN 

a - f/f DLBL ISBUILD,*PAYROLL 01',74/365,ISC 
b - // EXTENT SYS005,000001,4,0,1000,20 

c - // EXTENT SYS005,000001,4,1,1020,140 

d - // EXTENT SYSO005,000001,1,2,3000, 1000 

e - // EXTENT SYSO006, 000002,1,3,0020, 3960 

f - /f EXTENT SYS007,000003,1,4,0020,1160 

g - // EXTENT SYSO007,000003,2,5,1180, 1440 

F | 


INDEX SEQUENTIAL INTERNALS 


OPEN 


a - The master and cylinder indexes must be on the same 
symbolic unit and have only one entry in the M table 


c 

xX*'06!* | 

IJHAHRAA + 12 decimal - Use the ADDRTR program listing of the 
the ISMOD to determine this 


4 

a- 1 

b- 2 

c- 3 

d- 4 
ISBUILD.E 
UX* FF 


17 decimal - Refer to the ERREXT parameter for ISAM in the 
Supervisor and I/O Macro SRL 

False | 

To test for an EOF record on either the independent 
overflow area or prime data area. 
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CRS NE SLES ELE CE TEI ENC OTS EE IE LIED LETS LSE CEES SE OE LOPLLELD SNE) ELD AEE MENDED LIER STEEN TERS SLL NTE DS CERT REIN) SSIES GORGES LEED CAESED) STATE RIE 


- Only fixed unblocked records are supported 

- Only forward reading is allowed 

- Rewind options are not provided , 

- Combined file processing is not supported for reader 

punches | 

- CNTRL and PRTOV macros cannot be used with this macro 

Reading and writing of standard or user - standard labels 
for tape/disk is not supported. 

- If ASA control character code is used ina multi-tasking 
environment and more than one DTF uses the same module with 
RDONLY= =YES, Overprinting may occur 

If DTFDI is used with DASD, FOPT SYSFIL must have been 
specified at system generation time 

DELETE=NO 

NOTEPNT= (Used for work files in general) 

TYPEFILE= 

Chart PA 

OSO4I "ILLEGAL SVC 50" message - Use LIOCS ~ Volume 2 Chart PA 

for 1- I/O Area or Chart PB for 2 - I/0 Areas 
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False 

RSTADR (2nd operand) 

b, a 

the number of a previously taken checkpoint at which the 
program is to be restarted 

Cc 

True 

Cc 

True 

e (Bytes 0 to 8 of the record will contain /// CHKPT and byte 9 
will contain X"40*.). 

False - (GP regs are saved in bytes 16 to 79 of the first 
record written on disk - the header record) 

True - (This bit being 0 indicates that the program being 
checkpointed (on tape) was executing in real mode) 

False 

c (The third operand in a CHKPT macro has heen improperly 
specified) 

c (The checkpoint record is an extent record (XTN in first 3 
bytes) which was written because the Supervisor had been 
generated with the DASD file protect feature) 
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160 


PRIME DATA CYLINDER 


Map 


Record —> 


Cylinder Overflow Control Record 
Track Index (normal entry) 


LEGEND: 


Track index (overflow entry) 


COCR 
TIN 
TIO 


Added Record (after file was originally created) 


CL 


SS EN Or EMS, SE ee 


INDEPENDENT OVERFLOW CYLINDER [155 | 


APPEN 


D 


iX_ 


of the Records Contained in the ISAM File for Work Project 13. 
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APPENDIX B 


DOS/VS_ PROBLEM DETERMINATION TECHNIQUES 


The following information is provided to assist you in developing a 
logical approach to programming oriented problems. Use of the 

DOS/VS SADP manual further explains this approach and will be referenced 
where applicable. Consider the following points: 


@ Program troubleshooting can be simplified by following a few 
Simple techniques. 
@ The key to effective troubleshooting is the obtaining of all 


possible documentation and the recording of the error indications. 
The documentation should include program descriptions, listings, 
flowcharts, and a storage dump. 
@ The following items should be determined and/or obtained when 
debugging programs: 
1. Type of Failure 
- Incorrect output 
- Error message(s) 
~ System goes into wait state 
- Program goes into non-ending loop 
Zs Indications 
- SYSLOG message(s) 
~ Storage dump 
- Console indicators and low 
- Storage messages 
- Status of I/0 devices 
34 Program Operating Environment 
- DOS/VS with POWER, HASP, CICS, etc 
4. Program or Phase-In Control at the time 
of the failure | 
- The partition communication region contains the name of 
the program that was being executed when the failure occurred. 


Reference the flowchart (Figure 1) and read the following text which 
describes the significance of each block in the chart. 
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Trouble 


Reported or 
Observed 


Description A 


Preliminary 
Analysis 


System in rogram ue Incorrect Error _ 
Non-Ending 
Wait State Loop Output Message 


B 
Label 
Errors 


Recording 


Troubles 
Found 


Figure 1- Generalized Flowchart for Troubleshooting 
| APPENDIX B (Part 2 of 8) 
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Description A - Preliminary Analysis 


Is the problem such that wrong output was obtained from an 
apparently good run? For instance, was the OPTION statement card 
ignored during an assembly, but the assembly otherwise okay? If 
this is your problem, go directly to Description D; if not, 
continue on. 


Now determine the program and/or phase that was in control. You can 
look in the communication region (bytes 36-39) for the last phase 
fetched high core address. The address of the communication region 
can be found in bytes 16-17 (hex). 


Was the problem an error message? If so, go directly to Description 
E; if not, continue on. 


Is the machine in the wait state? If so, go to Description C; if not, 
continue on. 


If you arrived at this point, you will need to use your own 
troubleshooting techniques. Remember that you should obtain all 
possible documentation including storage dumps, program listings, 
LIST I/O, MAP, DSERV of core image library, change level macro, 
supervisor listing, and phase trace if available. 


escription B - Machine in Wait State 


Only two ways a wait state can he entered: 

1. An interrupt 

2- A LPSW instruction. Storage Address Register (SAR) will 
point to the PSW that was loaded. 


Utilize Chart 03 (6 parts) in Section 3 of the SADP manual to 


determine the course of action. 


Interrogate any message associated with the WAIT to determine 
if there is an alternate course of action. 


A wait state is also entered if all problen programs are waiting 
for an T/O interrupt. 


Reference Section 1 in the SADP manual for further information in 
determining the cause of a wait state. 
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Description C - Program in Non-Ending Loop (Section 3 of SADP) 


® Stop the CPU and use the documentary console to display the 
current PSW via the DP command. 

® Utilize SDAIDS with Instruction Fetch (IF) Trace to determine 
the addresses and instructions involved in the loop. 

e Obtain a storage dump of the looping progran. 

@ Whileaway from the machine, analyze the program listing to 


determine the cause of the non-ending loop. 


ED Ey ERD CEM APES LG ATES CEP LOLS ELLE SPEED | 


@ If the problem is an assembler or compiler error, try to assemble 
or compile the smallest input deck that will still show up the error. 
1. Once the failing input card type has been determined, consult 
the necessary PLM to determine what phase of the program 
processes that card type. 
2 It may be necessary to get a storage dump with a particular 
phase in storage. 


Suggestions on how to do this: 

ae Unready some I/O device which will be used by that phase. 

b. SAR STOP DELAY in the fetch routine and examine the 
partition communication region bytes (36-39). 

Ce Enter a phase trace rontine. (PDAIDS, F/L trace) 

d. Once the correct phase is in storage, take a standalone 
dump or force a program check by altering some instruction. 


Questions to ask yourself: 


1. Was the physical record duplicated, missing, or wrong length? 
2 Was a logical record duplicated, missing or wrong length? 
3. Did an I/O error occur, causing error recovery routines to 
be used? 
q. Was the file opened and closed properly? 
oie Was the alternate device being used? 


6. Did the error occur at the same time as some physical operation 
(ie, sensing of tape load point, EOF)? 
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Description E - Error Message 


TL SS TS 


(Reference Message Manual - Introductory Section) 


e Multiprogram ID: 


BG - Background program 
F1 - Foreground 1 program 
F2 - Foreground 2 progran 
F3 - Foreground 3 program 
F4 - Foreground 4 progran 
AR - Attention routine 


Consider the following: 


e Program Check - QSO3I | 
- Check interruption code (refer to the Reference Summary Card 
and the Principals of Operations SRL). 7 
- Location - Where the op code for the failing instruction is 
located. 
- Condition Code - Obtain from the PSW. 


How far did the program run? 
1. Check what I/O operation occurred 
2. Look at the GP registers 
ae 1 may be pointing to a DTF or CCB 


b. 14 may have a return point address (link register) 
Cc. 15 may be pointing to a logic module or subroutine. 
3. Is its base register loaded? 
e Program Check OQS11I 


~ Occurred in the logical transient area. 

- Rerun the program with the wait bit on in the Program Check New PSHW. 
Then take a standalone dump. Instruction on how to do this can 
be found under the message OS11I. 


e Label error messages will usually have a 4Xnn format. The '4* 
character logical IOCS. The 'X* character (when it equals 2 | 
through 9) indicates the type of file or operation (IS, SEQ, DA, 
TAPE, WORK FILES, OPEN/CLOSE), and 'n* is the message number. 
Messages pertaining to disk OPEN or CLOSE can be answered with 
DSPLYV to obtain VTOC information. 


e If a message must be looked at in depth, use the appropriate PLM 
for system control or LIOCS to find (in the message cross-reference 
Chart) which routine issued the message. 
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® Consult the PSGI Handbook (General PSM 4) for information on APAR 
Procedures. 


For additional and more detailed approaches to programming problems, 
consult the SADP manual (in the Introduction Section, under the title 
"Types of Malfunctions"). 
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®& FETCH ROUTINE REGISTER CONVENTIONS 


Fetch Any Phase 
svc 1 R1 = Address of the phase name to ke fetched. 


May contain '0O* or an entry address which 
overrides the link edited entry address. 


Fetch A Logical (8) Transient 


Address of the B-transient name to be fetched 


SVC 2 R1 = 
RO = Ignored 
R15 = Is set equal to the address of the LTA by the fetch 


routine. Control is passed to the LTA address +8. 


Fetch or Return from a_ Physical (A) Transient 
- Address of the A-transicnt name 
RO = Ignored 
= Is set equal to the address of the PTA by the 
fetch routine. Control is passed to the PTA address +8 


Svc 4 R1- Address of the phase name when issuing the SVC 4, 
upon return to the user Ri = the entry address. 
RO = May contain '0* or a load address which overrides the 
linkedited load address. 


© Load Phase Header 


Address of the phase name 
Address of where the load address is to be stored 


ss] 
_ © 
| 


NOTE: - This SVC can only be issued in a MPS Supervisor by a 
program whose protection key is "0. (Normally, 
job control and B-transients). 
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LOGICAL IOCS REGISTER CONVENTIONS ® 


Register 15 Points to the beginning of the logic module. (Branch 
instructions using this register will also have a 
displacement to allow entering the module at specific 
locations.) | 


Register 14 Linkage register. It points to the instruction in the 
Main program to wanich the logic module will return control. 
(The instruction following the branch to the logic module). 


Register 1 Points to the first byte of the DTF table (which is the 
beginning of the CCB). 
Register 0 Parameter register containing different values for 


OPEN/CLOSE or. GET/PUT. 


OPEN/CLOSE - Points to a list of adcons that contain 
addresses of the DIFs to be opened or closed. The end 
of the DTF list is indicated by the high order byte of 
the adcon being non-zero. 


GET/PUT -— Register 0 points to an adcon containing the 
address of the work area if one is used. 


If you are unfamiliar with a given system, the following procedures will & 
allow you to determine the size and entries in the PUB and LUB tables. 


le IPL in the normal mannec using the console for a communications 
device. 

2. Enter LISTIO ALL to determine the assigaments. 

3. Enter LISTIO UP to determine PUB values that are not currently 
assigned because the operator had flagged them as being down. 


APPENDIX B (Part 8 of 8) 


486 


L8h 


APPENDIX C 


eo RG RRR RR RRR RR kkk kkk dR RR EEK EDOS/VS SYSTEM CONTROL BLOCKS #24 4 0552 AR RO IGE RE BR kK 


ABTAB 

ACCTCOMN 
ACCTPP 

ANCHTAB 
ASYSBLKO 
ASYSBLKX 

BBOX 

CCB 

CCB COPY BLOCK 
CCW 


CCW COPY BLOCK 


ABNORMAL TERMINATION OPTION TABLE 

JOB ACCOUNTING INTERFACE COMMON TABLE 
JOB ACCOUNTING INTERFACE PARTITION 
TABLE 

ANCHOR TABLE 

ADDR OF DUMMY CFIRST)SYS TASK BLOCK 
ADDR OF TASK BLOCK OF ACTIVE SYS BLOCK 


BOUNDARY BOX 


COMMAND CONTROL BLOCK 


CHANNEL COMMAND WORD 


X'54-57' SYSCOM 
DOS/VS HANDBOOK 


X'7C-7F' SYSCOM 
DOS/VS HANDBOOK 


X'74-77' COMREG 
DOS/VS HANDBOOK 


GETVIS AREA-VIRT PAR 


SUPERVISOR PLM 


X'98-9B' SYSCOM 
DOS/VS HANDBOOK 


X'9C-9B' SYSCOM 
DOS/VS HANDBOOK 


X'DC-DF' SYSCOM 


DOS/VS HANDBOOK | 


GENERAL REG 1 


DOS/VS HANDBOOK, 


X'14-17' TCB 
DOS/VS HANDBOOK 
CCB 

YELLOW CARD 


X'20' CCB COPY BLOCK 


DOS/VS HANDBOOK 


88h 


CCWTADR 
CHANQ 
CHNTAB 
COMREG 
CRTTAB 
DIBTAB 
DPDTAB 


ECB 


ERBLOC 
ERPIBQ 
ERQI 
FAVP 
FICL 


FLPTR 


CHANNEL PROGRAM TRANSLATION ROUTINE 
CHANNEL QUEUE TABLE 

CHANNEL CONTROL TABLE 

PARTITION COMMUNICATIONS REGION 

CRT CONSTANT TABLE 

DISK INFORMATION BLOCK TABLE 

PAGE DATA SET TABLE 


EVENT CONTROL BLOCK 


ERROR RECOVERY BLOCK 
ERROR RECOVERY PROCEDURE INFO BLOCK 
ERROR QUEUE ENTRY 


FIRST AVAILABLE POINTER 


SPACE IN JIBTAB 


FIRST IN CLASS LIST 
POINTS TO FIRST ENTRY IN LUBTAB FOR PARTITION 


FREE LIST POINTER 
DISPLACEMENT INDEX INTO CHANNEL QUEUE 


X'84-87' SYSCOM 
DOS/VS HANDBOOK 


X'25-27' SYSCOM 
DOS/VS HANDBOOK 


X'3C-3F' SYSCOM 
DOS/VS HANDBOOK 


X'14-17' MAIN STORAG 
DOS/VS HANDBOOK 


X'34-37' SYSCOM 
DOS/VS HANDBOOK 


X'60-61' COMREG 
DOS/VS HANDBOOK 


X'EO0-E3' SYSCOM 
DOS/VS HANDBOOK 


DOS/VS HANDBOOK 


X'0-3' SYSCOM 
DOS/VS HANDBOOK 


SUPERVISOR LISTING 
DOS/VS HANDBOOK 


X'10' ERBLOC 
DOS/VS HANDBOOK 
X'42-43' COMREG 


X'48-49' COMPEG 


X* 24" SYSCOM 


ee 


68h 


- a 


FOCL 


FTTAB 


HLDPSW 


HQPUBTAB 


TIDAL 


ITREQ 


ITTAB 


JIBTAB 


LIK 


LMT 


LTA 


LTK 


LUBTAB 


MODTAB CLMT) 


MVCFLD 


NICL 


) | © 


FIRST ON CHANNEL LIST 


FETCH TABLE 


LAST SAVED CURRENT PSW 


HEADQUEUVE PUB TABLE 
INDIRECT DATA ADDRESS LIST 
INTERVAL TIMER REQ TABLE 
INTERVAL TIMER OPTION TABLE 
JOB INFORMATION BLOCK 
LOGICAL TRANSIENT ID KEY 
LINE MODE TABLE 


LOGICAL TRANSIENT AREA 


LOGICAL TRANSIENT KEY 
LOGICAL UNIT BLOCK TABLE 


LINE MODE TABLE 


MOVE CHARACTER FIELD CTASK SELECTION) 


NUMBER IN CLASS LIST 


HAS NUMBER OF LUBS IN PARTITION 


X'3E-3F' COMREG 
SUPERVISOR PLM 


X'FQ-F3' SYSCOM 
DOS/VS HANDBOOK 


LABEL IN SUPERVISOR 


X'14-17' RASLINK 
DOS/VS HANDBOOK 


X'1-3' COPIED CCW 
SUPERVISOR PLM 


X'50-53' SYSCOM 
DOS/VS HANDBOOK 


X'66-67' SYSCOM 
DOS/VS HANDBOOK 


X'44-45" COMREG 
DOS/VS HANDBOOK. 


X'58-59' SYSCOM 
DOS/VS HANDBOOK 


X'8C-8F' SYSCOM 
DOS/VS: HANDBOOK 


X'1C-1F' SYSCOM 


X'6E-6F' COMREG 
DOS/VS HANDBOOK 


X'4C-4D"' COMREG. 
DOS/VS HANDBOOK 


X'8C-8F' SYSCOM 
DOS/VS HANDBOOK 


X'B4-B7' SYSCOM 
SUPERVISOR PLM 


X'4A-4B' COMREG 


OCTAB OPERATOR COMMUNICATION OPTION TABLE X'68-69' COMREG 
DOS/VS HANDBOOK 


PAGETAB | PAGEIN TABLE LABEL PAGETAB SUP LI 
2 DOS/VS HANDBOOK 
PCTAB PROGRAM CHECK OPTION TABLE X'64-65' COMREG 
DOS/VS HANDBOOK 
PDTABA MICR DTF ADDRESSES X'7E-7F' COMREG 
| DOS/VS HANDBOOK 
PDTABB MICR DTF POINTERS X'7E-7F' COMREG 
DOS/VS HANDBOOK 
PFATAB PAGE FAULT HANDLING OVERLAP TABLE DOS/VS HANDBOOK 
PFT PAGE FRAME TABLE | — X'D4-D7' SYSCOM 


DOS/VS HANDBOOK 


PFTX PAGE FRAME TABLE EXTENTION X'D8-DB' SYSCOM 
| DOS/VS HANDBOOK 


06n 


PGQU PAGE QUEUE TABLE | X'1C-1F' RASLINK 
DOS/VS HANDBOOK 


PIBTAB PROGRAM INFORMATION BLOCK X'5A-5B' COMREG 
DOS/VS HANDBOOK 


PIB2TAB PROGRAM INFORMATION BLOCK EXTENTION X'7C-7D' COMREG 
DOS/VS HANDBOOK 


PIK PARTITION ID KEY X'2E-2F' COMREG 
DOS/VS HANDBOOK 


POWERTAB POWER TABLE X'5C-5F' SYSCOM 
| DOS/VS HANDBOOK 


PSW PROGRAM STATUS WORD LOW CORE 
| YELLOW CARD 


PT | PAGE TABLE SEGMENT TABLE 
DOS/VS HANDBOOK 


L6H 


PTA 


PUBOWNER © 


PUBTAB 


PUB2AREA 


RASLINK 


RASTAB 


RCB 


REGSAV 


RFTAB 


RTA 


RID 


RURTAB 


SAB 


SAVEAREAS 


SLD 


e 
PHYSICAL TRANSIENT AREA 
PHYSICAL UNIT BLOCK OWNERSHIP TABLE 
PHYSICAL UNIT BLOCK TABLE 
PUB 2 AREA 
RAS LINKAGE AREA 
RAS TABLE 


RESOURCE CONTROL BLOCK 


CHANNEL BUCKETS 
RECORDER FILE TABLE 


RECOVERY CRAS) TRANSIENT AREA 


ROUTINE ID OR REQUESTOR ID 
RESOURCE USAGE RECORD TABLE 
SEEK ADDRESS BLOCK 


PARTITION 
SYSTEM PARTITION 
SYSTEM TASK 


SECOND LEVEL DIRECTORY 


X'94-97' SYSCOM 


X'78-7B' SYSCOM 
DOS/VS HANDBOOK 


X'40-41" COMREG 
DOS/VS HANDBOOK 


X'30' RFTAB 
DOS/VS HANDBOOK 


X'70-73' SYSCOM 
DOS/VS HANDBOOK 


X'O0C-OF' RASLINK 
SUPERVISOR PLM 


DOS/VS HANDBOOK 


X'30-33' SYSCOM 
DOS/VS HANDBOOK 


X'64-67' SYSCOM 
DOS/VS HANDBOOK 


X'68-6F' CCCW) RASTA 


LABEL IN SUPERVISOR 


SUPERVISOR PLM 


LABEL RURTAB SUP LIS 


DOS/VS HANDBOOK 


X'38-3B' SYSCOM 
DOS/VS HANDBOOK 


X'05-08!' JIB 
X'09-0C' JIB 
X'05-08' STCB 


X'1-3' FTTAB 
DOS/VYS HANDBOOK 


C6t 


STAB 


STCB 


STID 


STOW TABLE 


SVA 


SYSCOM 


SYSTEM TASK BLOCKS 


TCB 


TIDFLD CMVCFLD) 


TIK 


TRTFLD CTRFLD) 


SEGMENT TABLE 


SYSTEM TASK CONTROL BLOCK 


SYSTEM TASK ID FIELDCSELECT BYTE) 


COMMUNICATION AREA FOR JOB CONTROL AND 
SMAINDIR 


SHARED VIRTUAL AREA 


SYSTEM CONTROL PROGRAM COMMUNICATION 
REGION 


TRANSLATION CONTROL BLOCK 
SYSTEM PIK OR TIC 
TASK IDENTIFICATION KEY 


TRANSLATE AND TEST FIELD 


X'DO-D3' IN SYSCOM 
DOS/VS HANDBOOK 


X'90-9B' SYSCOM PLUS 
SYSPTR 
DOS/VS HANDBOOK 


X'44-45' SYSCOM 
DOS/VS HANDBOOK 


X'18-24' SVA 
X'F5-F7' SYSCOM 
DOS/VS HANDBOOK 


X'80-84' LOW CORE 
DOS/VS HANDBOOK 


X'98-9B' SYSCOM 
DOS/VS HANDBOOK 


X'09' PIBTAB + X'50! 
DOS/VS HANDBOOK 


X'B4-B7' SYSCOM 
SUPERVISOR PLM 


X'5A-5B' SYSCOM 
DOS/VS HANDBOOK 


LABEL IN SUPERVISOR 
SUPERVISOR PLM 


Type of Interrupt | APPENDIX D 


Machine Yes 
Check 
| No 
Program 
Check 


@ 


Determine 
Severity and 
Attempt Recovery 


Yes 


Determine Cause- 
Cancel User Program 

Stop SUPVR if Nota TE 
Enter PGMGR if a TE 


Check for Valid SVC- 
Execute Routines for 
That Function 


Check Device Status- 
Determine if EREP is 
Needed - Post Device 
Status to User CCB and 
SUPVR - Dequeue Channel 
Queue Entry 


| No 
System Task, User Task or 
Bad News Partition Ready-To-Run; or 
{| Load a WAIT PSW | 


[FE 122733] 


Determine Type- 
if Timer, Go to Timer 
Routine 


TASK Selection - Determine 
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